The Config repository

The config repository is a special project used to configure many Software Factory services. It is similar to the openstack-infra/project-config repository, it enables users to submit configuration changes through the code review system. Once a change has been approved, the config-update job is executed to apply the new configuration.

To make a change in the configuration:

• First clone the repository: git clone https://<fqdn>/r/config
• Edit the relevant files and commit: git commit
• Submit a change for review: git review
• The configuration will be updated once the change is approved and merged

Note

Files starting by a “_” are default settings and they may be modified by an upgrade of Software Factory, thus they shouldn’t be modified manually. Note that the default settings are managed in this role sf-config/ansible/roles/sf-repos/templates, and contributions to improve them are welcome.

• Managing resources via the config repository
  • Advantages of managing resources via the config repository
  • How it works
  • A more complete example
  • Resource deletion
  • Integration with Zuul
  • Define a github project in the resources
• Zuul user documentation
  • Adding a project to the zuul service
  • Adding a predefined job to a project
  • Defining a custom job within a project
  • Export logs artifacts to the logserver
  • Export logs artifacts to logstash
  • Create a secret to be used in jobs
  • Web Interface
  • Install a GitHub App
  • Configure branch protection
• Nodepool user documentation
  • Cloud provider tuning
  • Adding extra labels or cloud-image to a provider
  • Building Images Using Virt Customize
  • Diskimage elements
  • Using extra elements
  • Adding custom elements
  • Building RHEL images
• Gerritbot notification channels configuration
• Configure Gerrit git repositories replication
  • Introduction
  • Configure the replication for a repository
  • Get the replication SSH public key
  • Configuring repository replication on Github
• Gerrit comments link customisation
• API access control
• RepoXplorer
  • Manual configuration
• Publish static web content
  • Activate the build-pages job
  • Activate the build-and-publish-pages job
  • Hostname resolution
• Firehose
  • Services supported
  • Events published
  • Subscribing to events
• System and services metrics
  • Defaults dashboards
  • Customs dashboards