Chapter 3. Integrating pre-existing deployments and outside products

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. Run the integration command. Replace $ENDPOINT with your ACS central endpoint URL, and $TOKEN with your ACS API token.

   rhtap-cli integration acs --endpoint="$ENDPOINT" --token="$TOKEN" --config="$CONFIG"

   Copy to Clipboard Toggle word wrap

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, 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).

    $ rhtap-cli integration quay --dockerconfigjson="$DOCKERCONFIGJSON" --token="$API_TOKEN" --url="$URL" --config="$CONFIG"

    Copy to Clipboard Toggle word wrap

Procedure

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

   $ rhtap-cli integration gitlab --token="$API_TOKEN" --host="$URL" --config="$CONFIG"

   Copy to Clipboard Toggle word wrap

Procedure

1. In your CLI, run the integration command. Replace $API_TOKEN with your Jenkins API token, $URL with you Jenkins instance URL, $USERNAME with your Jenkins user ID.

   $ rhtap-cli integration jenkins --token="$API_TOKEN" --url="$URL" --username="$USERNAME" --config="$CONFIG"

   Copy to Clipboard Toggle word wrap

Procedure

1. In the Artifactory UI, in the Administration view, click the green Set Up Client/CI Tool button next to the repository that you want to use.
2. Select Docker Client

3. Follow the UI instructions to authenticate in your CLI.

   1. The UI generates a token to use as a password. Make sure to save it in ~/install_values.txt.
   2. When you login to JFrog in your CLI, you should get a message saying your password has been stored in a location such as ~/.docker/config.json. If you do not see this message, a later step in this procedure explains what to do.

4. In your CLI, run the integration command. Set the value of ARTIFACTORY_URL to the URL of your instance (for example, "https://myusername.jfrog.io"). Set the value of ARTIFACTORY_DOCKERCONFIGJSON to the contents of the file where your password was stored. Set the value of ARTIFACTORY_API_TOKEN to the token that JFrog generated.

   $ rhtap-cli integration artifactory --url="$ARTIFACTORY_URL" --dockerconfigjson="$ARTIFACTORY_DOCKERCONFIGJSON" --token="$ARTIFACTORY_API_TOKEN" --config="$CONFIG"

   Copy to Clipboard Toggle word wrap

Procedure

1. In your CLI, run the integration command. Replace $username with your Bitbucket username, and $appPassword with your Bitbucket access tokens. If you are integrating with a custom Bitbucket host, replace $URL with you Bitbucket host URL. If you are using the default bitbucket.org host, you can remove the --host option.

   $ rhtap-cli integration bitbucket --username="$username" --app-password="$access_token" --host="$URL" --config="$CONFIG"

   Copy to Clipboard Toggle word wrap