DEVELOPMENT.md

Linting

Dependencies

• catlin
• yamllint

Usage

make lint

Testing

Configuration

Env	Default	Description
TASKS	Tasks in task directory	Tasks to test. (format: <taskname:version>;<taskname:version>;...)
KUBECTLCMD	kubectl	Command to use instead of kubectl.

Tests may be ran on any of the following platforms via...

Ephemeral Environments

Running a full test entails setting up an ephemeral environment. This may be done by running the associated Make target:

Platform	Make target	Scripts
GKE	test-gke	gke
Kind	test-kind	kind
OpenShift	test-openshift	openshift

Example

make test-kind

Pre-existing Environment

Running tests on a pre-existing environments may be done by choosing the right kubeclt context and executing the following scripts...

Scripts

• scripts/platforms/1_k8s_setup.sh → Install Tekton
• scripts/platforms/2_run_tests.sh → Run tests of our tasks using the same mechanism provided by the Catalog.

Diffing

Compare tasks against latest version in Tekton Catalog.

Configuration

Env	Default	Description
TASKS	Tasks in task directory	Tasks to compare. (format: <taskname:version>;<taskname:version>;...)
DIFFCMD	git diff --no-index	Command to use for diff'ing task contents.

Usage

make diff

Docker Registry

Setting up a docker registry simplifies testing by not having to provide authentication to the tekton pipeline.

The following solution starts a local docker registry but routes it publically via ngrok so that communication can occur using https without having to deal with certificates.

Dependencies

• docker
• ngrok

Steps

1. Start docker registry

   docker run --rm -e REGISTRY_STORAGE_DELETE_ENABLED=true -d -p 5000:5000 registry:2

2. Forward port via ngrok

   ngrok http 5000
   

3. Reference images using the domain provided by ngrok (ie. aebbf67b0993.ngrok.io)

   aebbf67b0993.ngrok.io/myorg/myapp