Skip to content

Latest commit

 

History

History
58 lines (40 loc) · 2.64 KB

README.md

File metadata and controls

58 lines (40 loc) · 2.64 KB
Raw

Pipelines Service in Openshift

Description

This script essentially does this :

  1. Install OpenShift GitOps on the cluster.
  2. Deploy Pipelines Service on the cluster via an ArgoCD application.

Dependencies

Before installing the prerequisites, refer DEPENDENCIES.md to verify the versions of products, operators and tools used in Pipeline Service.

Pre-requisites

Before you execute the script, you need:

  1. to have an OpenShift cluster with at least 6 CPU cores and 16GB RAM.
  2. to install kubectl
  3. to install oc
  4. to install argocd CLI
  5. to install yq

You can run the dev_setup.sh script with or without parameters. The --use-current-branch parameter should be used when testing manifests changes.

The test.sh script runs certain examples from tektoncd repo for pipelines. You can run the below script only after dev_setup.sh is run and the required resources are up and running.

./test.sh --test pipelines
    # Runs a minimal PipelineRun
    # Checks that the pipelinerun is successful.

./test.sh --test chains
    # Simulates the creation of an image
    # Checks that the pipeline and image are signed.
    # Checks that the key to decode the signed data is available to all users.

./test.sh --test results
    # Checks that logs are uploaded by tekton-results.

Development - Onboarding a new component

This developer environment can be used to develop/test a new component on the Pipeline Service by changing parameters in config.yaml. Considerations for testing a new component:

  1. We are deploying various applications using the GitOps approach and hence a user would need to change the values of git_url and git_ref to reflect their own Git repository.
  2. A user can modify the applications to be deployed on the cluster by modifying the apps field.
  3. Onboarding a new component requires creating a new Argo CD application in argo-apps and adding it to kustomization.yaml.
  4. For testing, users need to modify only the git source path and ref of their Argo CD application to reflect their own Git repo.

Reset

One can reset its environment and all the resources deployed by dev scripts:

developer/openshift/reset.sh --work-dir /path/to/my_dir