Deployment Pipelines

Automated Tekton deployments from GitHub.

A complete step-by-step tutorial is provided here.

Requirements

• A Quay.io account that you can generate read/write credentials for.
• A pull-secret for the Docker image repository, if your repository is public, you may not need this, and may need to edit the files, see Quay pull secrets below for how to do this for Quay.io.
• A Docker configuration to access your image host, if you're using Quay.io, see Quay docker config for instructions.
• A running OpenShift cluster that can be exposed to the internet - and you must be logged in at the command-line.
• Two GitHub repositories, a main repo e.g. bigkevmcd/taxi and a configuration repo bigkevmcd/taxi-stage-config, the stage-config name is derived automatically from the main repo.
• A Personal GitHub auth token, placed into a file called `$HOME/Downloads/token" see https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line

Updating the configuration

$ ./bootstrap.sh <QUAYIO_USERNAME> <main github repository> <prefix> <optional path to deployment.yaml>

The prefix is used to name the environments to avoid collisions in a shared cluster, you can use your initials, or username e.g. "kevin" would result in environments "kevin-dev-environment", "kevin-stage-environment" and "kevin-cicd-environment" being created.

NOTE: IF YOUR deployment.yaml is NOT in a deploy directory at the top-level of your repository, you will need to provide the path as a parameter here, e.g. if you're keeping your deployment.yaml in k8s at the top-level, provide k8s as a third argument to the script.

At this point, a lot of YAML files and things will scroll down the screen, and it will take some time for new containers to be spawned.

Public Image Repositories

TODO

Quay Pull Secrets

Visit the settings page for your Quay.io account "https://quay.io/user/<USERNAME>?tab=settings"

You'll be prompted to authenticate, and then you'll get a screen that allows you download credential, pick the "Kubernetes Secret" on the left hand of the screen.

On this screen, there is a link below "Step 1", to download your secret "Download -secret.yml", download this file and leave it in $HOME/Downloads.

Quay Docker Config

Visit the settings page for your Quay.io account "https://quay.io/user/<USERNAME>?tab=settings"

You'll be prompted to authenticate, and then you'll get a screen that allows you download credential, pick the "Docker Configuraiton" on the left hand of the screen.

On this screen, there is a link below "Step 1", to download your secret "Download -auth.json", download this file and leave it in $HOME/Downloads.