Testing CloudOps for Kubernetes · CloudOps for Kubernetes

CloudOps for Kubernetes includes several Jenkins pipelines that run through a complete CloudOps for Kubernetes and Elastic Path Commerce workflow. You can use these jobs as the basis for a CloudOps for Kubernetes CI pipeline.

Scheduled CloudOps Pipelines

CloudOps for Kubernetes includes several CloudOps for Kubernetes workflow pipelines. These pipelines are used internally to validate released and upcoming version of CloudOps for Kubernetes are working.

These pipelines run on a schedule. Each supported CloudOps version is tested every night.

Scheduled Commerce Pipelines

CloudOps for Kubernetes includes several Commerce workflow pipelines. These pipelines are used internally to validate compatibility with the Commerce versions CloudOps for Kubernetes supports.

These pipelines run on a schedule. At least one pipeline runs each night.

On-demand Cloudops Pipeline

CloudOps for Kubernetes includes a CloudOps for Kuberentes workflow pipeline that is not scheduled. This pipeline can be configured and run to test different combinations of CloudOps, Commerce and EP Docker branches. For more information about the parameters, see CloudOps Pipeline Parameters.

On-demand Commerce Pipeline

The on-demand Commerce CI pipeline is important to all projects and is included by default. It does not need to be specifically enabled like other pipelines in this section.

For more information about the on-demand Commerce CI pipeline, see the Commerce CI Pipeline section.

Enabling the CloudOps CI Pipelines

By default, the CloudOps CI pipelines are excluded from Jenkins. Most project do not need the CloudOps CI pipelines.

To enable the CloudOps CI pipelines:

Download the Docker Compose configuration file for your cluster.

tip

If you followed the recommended process for bootstrapping your cluster, the file name is docker-compose.override.yml.

Add the following settings to your Docker Compose configuration file.

# required to enable CloudOps Jenkins pipelines
TF_VAR_include_c4k_pipelines: "true"

# required to enable communication with the Jenkins servers created nightly by the CloudOps pipelines
TF_VAR_jenkins_trust_all_certificates: "true"

# required to build unreleased Elastic Path Commerce versions
TF_VAR_ep_cortex_maven_repo_url: "https://repository.elasticpath.com/nexus/content/repositories/cortex-staging/"
TF_VAR_ep_commerce_engine_maven_repo_url: "https://repository.elasticpath.com/nexus/content/repositories/commerce-engine-staging/"
TF_VAR_ep_accelerators_maven_repo_url: "https://repository.elasticpath.com/nexus/content/repositories/accelerators-staging/"

Follow the process for updating your CloudOps for Kubernetes cluster.

CloudOps Pipeline Parameters

The following parameters are available in CloudOps for Kubernetes workflow pipelines:

`centralhubCIDR`

IP CIDR blocks allowed to access the Jenkins and Nexus servers in the CloudOps for Kubernetes cluster created by the pipeline. For CloudOps for Kubernetes release versions greater than 2.2.

`jenkinsIngressCIDR`

IP CIDR blocks allowed to access the Jenkins server in the CloudOps for Kubernetes cluster created by the pipeline. For CloudOps for Kubernetes release versions up to 2.2.

`nexusIngressCIDR`

IP CIDR blocks allowed to access the Nexus server in the CloudOps for Kubernetes cluster created by the pipeline. For CloudOps for Kubernetes release versions up to 2.2.

`kubernetesNickname`

The Kubernetes namespace where to deploy the CloudOps for Kubernetes bootstrap Pods.

`cleanupResourceGroup`

If cleanupResourceGroup is set, the job cleans up the resources it creates.

`forceCleanupResources`

If forceCleanupResources is set, the job runs the bootstrap Pod in force-clean mode before beginning the pipeline. This empties resources in the AWS account from previous runs.

`runCortexSystemTests`

If runCortexSystemTests is set, the job will run Cortex system tests against the deployed Commerce stack.

`kubernetesClusterName`

The name of the Kubernetes cluster to create.

`domainName`

The domain name for the created Kubernetes cluster. Use a subdomain of the domain name in zoneForNSRecord.

`zoneForNSRecord`

The name of the DNS Zone where name server records are created to point to the DNS Zone created by the bootstrap process.

`gitReposPrivateKey`

A private SSH key authorized to clone from repositories specified by cloudOpsForKubernetesRepoURL, epCommerceRepoURL and dockerRepoURL. The private SSH key must not be password protected.

`cloudOpsForKubernetesBranch`

The branch of CloudOps for Kubernetes to test.

`cloudOpsForKubernetesRepoURL`

The Git repository from which to pull CloudOps for Kubernetes code.

`epCommerceBranch`

The branch of Elastic Path Commerce to test.

`epCommerceRepoURL`

The Git repository from which to pull Elastic Path Commerce code.

`dockerBranch`

The branch of Elastic Path docker to test.