Chapter 3. Integrating instances of ACS, Quay, Jenkins

Procedure

1. Before you can integrate your instance of ACS, you need an API token and the central endpoint URL.

   1. Follow the instructions for the prerequisites here to create an API token. Save the token in ~/install_values.txt.
   2. Follow the instructions here to configure your endpoint. Save the URL in ~/install_values.txt.
2. In your CLI, login to the OpenShift cluster where you plan to install RHTAP.

3. Make sure you are in the rhtap-cli directory.

   $ cd ~/rhtap-cli

4. Run the integration command. Replace $ENDPOINT with your ACS central endpoint URL, and $TOKEN with your ACS API token.

   ./bin/rhtap-cli integration acs --endpoint="$ENDPOINT" --token="$TOKEN"

Procedure:

1. In your web browser, login to Quay. On the right side of the banner, select your username and select Account Settings from the dropdown menu.
2. On your user settings page, under Docker CLI Password, select Generate Encrypted Password. In the popup window, enter your password to authenticate.
3. Next, still in the popup window, select Docker Configuration > View [username]-auth.json. Copy the string, without the quotation marks, following "auth":.
4. In your ~/install_values.txt file, label and create the Docker configuration value with the following format, using your username and auth token where appropriate: {"auths": {"quay.io": {"auth": "[auth token]","email": ""}}}
5. Back in the Quay UI, return to the default Repositories page. On the right side, under Users and Organizations, select the Quay organization you want to use for RHTAP.
6. From the tabs on the left side, select Applications.
7. Click Create New Application. Give your application a name.
8. Click on the application’s name.
9. From the tabs on the left, select Generate Token.
10. From the options for permissions for the token, select View all visible repositories.
11. Click Generate Access Token.
12. Click Authorize Applicaiton.
13. The UI displays an access token. Label and save this token in ~/install_values.txt, too.

14. In your CLI, make sure you are in the rhtap-cli directory.

    $ cd ~/rhtap-cli

15. Run the following command to integrate your instance of Quay. Replace $DOCKERCONFIGJSON with the Docker configuration value. Replace $API_TOKEN with the token you just generated. And replace $URL with the address for your instance of Quay (https://quay.io if you have not installed Quay in your cluster).

    $ ./bin/rhtap-cli integration quay --dockerconfigjson="$DOCKERCONFIGJSON" --token="$API_TOKEN" --url="$URL"

Procedure

1. In your CLI, make sure you are in the rhtap-cli directory.

   $ cd ~/rhtap-cli

2. Run the integration command. Replace $API_TOKEN with your Jenkins API token, $URL with you Jenkins instance URL, $USERNAME with your Jenkins user ID.

   $ ./bin/rhtap-cli integration jenkins --token="$API_TOKEN" --url="$URL" --username="$USERNAME"

Procedure

1. In your CLI, make sure you are in the rhtap-cli directory.

   $ cd ~/rhtap-cli

2. Run the integration command. Replace $API_TOKEN with your GitLab API token. If you are integrating with a custom GitLab host, replace $HOST_URL with you GitLab host URL. If you are using the default gitlab.com host, you can remove the --host option.

   $ ./bin/rhtap-cli integration gitlab --token="$API_TOKEN" --host="$HOST_URL"