Quick Start

This section presents how to quickly get the services up and running in a few minutes. This allows you to easily test the services and check how Software Factory works. When you are satisfied, check the configuration file to customize the settings and the architecture file to enable extra services. Also check the deployment documentation for deployment options and how to setup network access control.

Minimal quickstart

On a CentOS-7 system, deploy the basic services (managesf, gerrit, zuul and nodepool) using these commands:

yum install -y https://softwarefactory-project.io/repos/sf-release-3.8.rpm
yum install -y sf-config
sfconfig

Note

By default the deployment will use “sftests.com” for the FQDN, you might want to set it locally in your /etc/hosts so that the web interface works properly.

Podman provider quickstart

The Nodepool service integrated in Software Factory comes with a kubernetes provider driver to enable simple podman container usage. The sfconfig configuration management comes with a hypervisor-k1s role that you can use to quickly setup and configure a test environment.

For this quickstart, we will use the main instance as the hypervisor:

echo "      - hypervisor-k1s" >> /etc/software-factory/arch.yaml
sfconfig --enable-insecure-workers

Note

Because the container doesn’t have network isolation, we have to use a sfconfig argument to enable the main host as a nodepool provider. Please check the the nodepool operator doc to properly deploy one or many dedicated k1s instances.

Third-Party-CI quickstart

To configure an external gerrit such as review.openstack.org, you’ll need to manually create a user on the remote gerrit. For openstack.org, follow this guide to configure it.

It’s recommended to first deploy a local installation, before adding the external gerrit. In that case, after your local deployment is validated, add the local zuul ssh public key (located here: /var/lib/software-factory/bootstrap-data/ssh_keys/zuul_rsa.pub) to the remote user ssh key setting page. Then add the new gerrit connection to /etc/software-factory/sfconfig.yaml file:

zuul:
  gerrit_connections:
    - name: review.openstack.org
      hostname: review.openstack.org
      port: 29418
      puburl: https://review.openstack.org
      username: external-gerrit-user-name
      # optional canonical_hostname
      canonical_hostname: git.openstack.org