b-douglas / wc-devops-utilities

WebSphere Commerce DevOps Utilities project provide Docker based tool chain to support deploy and manage Commerce V9+ environment on Kubernetes

Deploying WebSphere Commerce V9 with the DevOps Utilities

WebSphere commerce DevOps Utilities are provided as a reference tool chain to support deploying and operating WebSphere Commerce V9 in a Kubernetes environment.

For more information about WebSphere Commerce V9, see WebSphere Commerce Version 9 knowledge Center.

By using WebSphere Commerce DevOps Utilities, you can also deploy WebSphere Commerce V9+ in IBM Cloud Private (ICP). For more information on ICP, see IBM Cloud Private.

WebSphere Commerce DevOps Utilities are built and deployed as Docker images, including the following:

• DeployController
• DeploySlave
• SupportContainer
• Jenkins Slave Plugin Container

Docker image	Embedded assets	Role and description
DeployController	Jenkins/ Pre-defined Jenkins job/ DevOps backend scripts	A Jenkins-based tool to work as the controller to trigger related jobs and fulfill tasks such as environment deployment and Docker image build
DeploySlave	Dockerd / Helm client / DevOps backend scripts	Can be triggered by DeployController to build customized Docker image including your customization package and can then be deployed in the Kubernetes environment with Helm
SupportContainer	DevOps backend scripts	Handles Helm pre- and post-deployment hook/ Works as commander to control the startup sequence
Jenkins Slave Plugin Container	Jenkins Agent	A Jenkins slave using JNLP to establish connection ( You can download it from jenkinsci/jnlp-slave

Vault and Nexus Docker images, by default, are seamlessly integrated with the DevOps Utilities.

In the WebSphere Commerce DevOps utilities:

• Vault works as the Certification Agent to automatically issue certification as well as the remote configuration center to store environment related configurations. These configurations can be retrieved during Docker startup and set environment-specific configurations into the Docker container. For more information about Vault, see Managing certificates with Vault and Environment data structure in Consul/Vault.

• Nexus works as the store to manage your customization packages. The customization packages are retrieved from Nexus and burned into the custom docker image when the custom Docker image is built.

You can deploy the DevOps Utilities by using Helm Chart. For more information about Helm Chart, see Commerce DevOps Utilities Helm Charts

The following diagram shows the components of the WebSphere Commerce using DevOps Utilities.

Preparing Docker images for DevOps Utilities

Before you deploy WebSphere Commerce V9, build all required Docker images for WebSphere Commerce DevOps Utilities.

Before you run build Docker images, ensure that your machine has Docker (DockerCE or EE 17.06) installed and that your machine is connected to the Internet.

1. Go to the commerce-devops-utilities/kubernetes/DeployController directory, and run the following command to build the DeployController Docker image:

    ./BuildDocker.sh
   

   Note: you can specify the Docker image tag in the following pattern:

    ./BuildDocker.sh deploycontroller:<newtag>
   

   The kubernetes/DeployController folder contains the following files for customization:

   • plugins.txt: Includes New or updated plugin version
   • setup/jobs: Includes pre-defined Jenkins job.
   • users/admin/config.xml: Includes the default admin user information
   • config.xml:Includes global variables for Jenkins
   • jenkins.sh: Includes Jenkins startup logic

2. Go to the commerce-devops-utilities/kubernetes/DeploySlave directory, and run the following command to build the DeploySlave Docker image:

   ./BuildDocker.sh
   

   Note: You can specify the Docker image tag in the following pattern:

    ./BuildDocker.sh deployslave:<newtag>
   

3. Go to the commerce-devops-utilities/kubernetes/DeploySupportdirectory, and run the following command to build the DeploySupport Docker image:

   ./BuildDocker.sh
   

   Note: You can specify the Docker image tag in the following pattern:

   ./BuildDocker.sh deploysuppor:<newtag>
   

Deploying DevOps Utilites

To quickly deploy DevOps Utilities, you need to use Helm Chart. For more information about Helm Chart, see Commerce DevOps Utilities Helm Charts.

Ensure to deploy WebSphere Commerce DevOps Utilities under the default Kubernetes namespace.

Note: If you already have a WebSphere Commerce V9 environment deployed, or you do not want to deploy Utilities on the Kubernetes cluster or ICP, you can also manually deploy each DevOps utilities container to serve your existing environments.

After the deployment is completed, you can access the DeployController user interface by logging into http://IngressIPAddress:31899 with the default user name and password (admin/admin), and check the following pre-defined jobs:

Tip:

1. For each job in DeployController, make sure to open the config page and click Save, so that the Parameter plugin can be loaded.

2. Before you launch Jenkins Job, please make sure you have upload related Docker Image to private Docker Repository As default, Jenkins Job will download Docker Image under "commerce" library with latest tag from private Docker repository which you set in DeployController.

Using WebSphere Commerce Utilities

Refer to DeployController design for detailed information.

Project structure

The following table shows the folders included in the project.

Folder	Description
doc	Includes documents created in Markdown
utilities/DeployController	Includes the scripts for building DeployController Docker Image
utilities/DeploySlave	Includes the scripts for building DeploySlave Docker Image
utilities/DeploySupport	Includes the scripts for building SupportContainer Docker Image
utilities/Filebeat	Includes scripts to build Filebeat Docker Image for Commerce V9. See Logging Solution
utilities/EventAgent	Includes source code (golang) and scripts to build EventAgent Docker Image for Commerce V9. This Docker Image support pre-defined job "KubeExec_Base" which can exec command (e.g run engine command to set trace spec) on specified Pod
scripts	Includes DevOps backend scripts

Contributing to the project

After you try the DevOps utilities out, you are welcomed to contribute to this project by enriching the files list above and improving the documents.

If you'd like to do so, contact the administrators in the contact list so that you can be added as a project member.

You can also create issues directly to propose enhancements. We will evaluate and assign project members to fix or handle issues.

Related links

• Slack Channel

• Contact list

Others

• History