= riff CI

[grid="none", frame="none", cols=">,<,>,<,>,<", options="header"] |===== 2+| Pipelines 2+| Component Builds 2+| Invoker Builds // 1 | https://github.com/projectriff/ci/blob/master/pipelines/riff.yml[riff] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/badge[Riff Pipeline, link=https://ci.projectriff.io/teams/main/pipelines/riff] | https://github.com/projectriff/fats[Acceptance Tests] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/jobs/run-faas-acceptance-tests-gke/badge[Acceptance Tests Status, link=https://ci.projectriff.io/teams/main/pipelines/riff/jobs/run-faas-acceptance-tests-gke/builds/latest] | https://github.com/projectriff/java-function-invoker[Java Invoker] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/jobs/build-java-function-invoker-container/badge[Java Invoker, link=https://ci.projectriff.io/teams/main/pipelines/riff/jobs/build-java-function-invoker-container/builds/latest]

// 2 | https://github.com/projectriff/ci/blob/master/pipelines/riff-pr.yml[riff-pr] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff-pr/badge[Riff PR Pipeline, link=https://ci.projectriff.io/teams/main/pipelines/riff-pr] | https://github.com/projectriff/topic-controller[Topic Controller] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/jobs/build-topic-controller-container/badge[Topic Controller Status, link=https://ci.projectriff.io/teams/main/pipelines/riff/jobs/build-topic-controller-container/builds/latest] | https://github.com/projectriff/node-function-invoker[NodeJS Invoker] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/jobs/build-node-function-invoker-container/badge[NodeJS Invoker, link=https://ci.projectriff.io/teams/main/pipelines/riff/jobs/build-node-function-invoker-container/builds/latest]

// 3 | https://github.com/projectriff/ci/blob/master/pipelines/dockerimages.yml[dockerimages] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/badge[Riff Pipeline, link=https://ci.projectriff.io/teams/main/pipelines/dockerimages] | https://github.com/projectriff/function-controller[Function Controller] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/jobs/build-function-controller-container/badge[Function Controller Status, link=https://ci.projectriff.io/teams/main/pipelines/riff/jobs/build-function-controller-container/builds/latest] | https://github.com/projectriff/python2-function-invoker[Python2 Invoker] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/jobs/build-python2-function-invoker-container/badge[Python2 Invoker Status, link=https://ci.projectriff.io/teams/main/pipelines/riff/jobs/build-python2-function-invoker-containe/builds/latest]

// 4 | | | https://github.com/projectriff/http-gateway[HTTP Gateway] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/jobs/build-http-gateway-container/badge[HTTP Gateway Status, link=https://ci.projectriff.io/teams/main/pipelines/riff/jobs/build-http-gateway-container/builds/latest] | https://github.com/projectriff/shell-function-invoker[Shell Invoker] | image:https://ci.projectriff.io/api/v1/teams/main/pipelines/riff/jobs/build-shell-function-invoker-container/badge[Shell Invoker Status, link=https://ci.projectriff.io/teams/main/pipelines/riff/build-shell-function-invoker-container/builds/latest]

=== Concourse: https://ci.projectriff.io/

• We use Github auth. You must belong to either projectriff/riff-dev or projectriff/riff-watchers. Your membership needs to be public, https://github.com/orgs/projectriff/people[which you can configure here].
• Install fly locally http://concourse.ci/single-page.html#fly-cli
• Authenticate with Concourse: fly -t riff login --concourse-url https://ci.projectriff.io
• Install the LastPass CLI (lpass: https://github.com/lastpass/lastpass-cli) and ensure it is available on the PATH
• Log into LastPass CLI (must have access to the Shared-pfs-eng folder) lpass login <your-e-mail>
• When making changes to a pipeline, use ./set_pipeline.sh <pipeline-name> to submit changes upstream

=== Concourse BOSH

• Install the BOSH Bootloader CLI (bbl: https://github.com/cloudfoundry/bosh-bootloader)
• Install the BOSH CLI (bosh: https://bosh.io/docs/cli-v2.html#install)
• Log into LastPass (must have access to the Shared-pfs-eng folder)
• To set up the BBL environment, run ci/concourse/bbl/bbl_setup.sh
• To deploy Concourse, run ci/concourse/deploy_concourse

=== Versioning

• Container images and Helm charts built from riff are versioned using the Concourse semver resource.
• Build numbers for container images are automatically bumped each time a container is built
• All other version changes are operator/developer controlled

==== Bumping Patch Version

• Run the manual-images-version-bump-patch job to bump the patch version (from 0.0.1-build.12 to 0.0.2-build.1, for example)

==== Tagging Images for Release

• Run the manual-images-release job to tag the latest images with a stable [non-build] tag (Will tag a 0.0.1-build.12 image of a given component as 0.0.1).

=== Helm Charts

• Charts (and a corresponding index.yaml for the latest build) are published to https://riff-charts.storage.googleapis.com
• Default values in Helm charts need to be overridden with appropriate values, based on the container images used to make test the chart. A companion install script is published alongside each chart, named riff-<version>-install-example.sh