Deploy IBM Sterling Connect:Direct on OpenShift using Ansible Scripts
Playbook will run the last version of Connect:Direct, but take care of Kubernetes/Openshift version is supported
| Connect:Direct | OpenShift | Kubernetes | helm-chart | Helm |
|---|---|---|---|---|
| 6.4.0.0_ifix000 | >= 4.14 and <= 4.18 | >=1.27.0 <1.32.0 | 1.4.0 | >= 3.14.x |
| 6.3.0.3_ifix025 | >= 4.11 and <= 4.16 | >=1.24.0 <1.30.0 | 1.3.13 | >= 3.14.x |
| 6.3.0.3_ifix021 | >= 4.11 and <= 4.16 | >=1.24.0 <1.30.0 | 1.3.12 | >= 3.14.x |
| 6.3.0.3_ifix014 | >= 4.11 and <= 4.16 | >=1.24.0 <1.30.0 | 1.3.11 | >= 3.14.x |
Preparation
1. IBM Entitled Registry
You must have kubectl, oc, git and ansible installed in your machine
Log in the IBM Container software library with the IBMid and password that are associated with the entitled software. Click Get entitlement key. With key export variable
export ENTITLED_REGISTRY_KEY=<entitlement_key>
2. Login on OpenShift
Do a login in Openshift console and run the command:
oc login --token=sha256~P...k --server=https://c....containers.cloud.xxx.com:31234
3. Cloning ansible-ibm-websphere from git
git clone https://github.com/ibm-sterling-devops/ansible-ibm-sterling.git
4. Set roles path
To run playbook the playbook
cd ansible-ibm-sterling
export ANSIBLE_CONFIG=./ansible.cfg
Deploy you Connect:Direct
1) Define C:D node name
export CD_NODENAME=CDNODE01
2) To run the playbook
ansible-playbook playbooks/deploy_cd.yml
check for sterling-cdnode01-dev namespace. The C:D node name will be CDNODE01
Examples
Example 1: Change namespace and C:D node name
To change namespace/project and C:D node name
cd ansible-ibm-sterling
export CD_NAMESPACE=sterling-cdcompany01-prod
export CD_NODENAME=COMPANY01
ansible-playbook playbooks/deploy_cd.yml
Environment Variable
For all environment variables
Role Variables
Environment variables for this role:
| Environment Variable | Default Value | Required | Description |
|---|---|---|---|
| ENTITLED_REGISTRY_KEY | - | Yes | Entitlement registry key |
| CD_NAMESPACE | sterling-cdnode01-dev | No | Namespace for C:D application |
| CD_NODENAME | CDNODE01 | No | Specify the nodename of C:D |
| CD_VERSION | 6.3.0.3_ifix014 | No | Version of C:D container to deploy |
| CD_ADMINPASSWORD | passw0rd | No | Password for C:D Admin |
| CD_APPUSER_PWD | passw0rd | No | Password for C:D User |
| CD_LOCALCERTPASSPHRASE | changeit | No | Passphrase for local certificate |
| CD_KEYSTOREPASSWORD | changeit | No | Password for keystore |
| CD_LICENSE_TYPE | non-prod | No | License type for C:D (prod or non-prod) |
| CD_STORAGE_CLASS | - | No | Storage class to be used for the container |
| CD_STORAGE_CAPACITY | 1Gi | No | Storage capacity to be allocated to the container |
| CD_CPU_LIMITS | 500m | No | CPU limit for the container |
| CD_MEM_LIMITS | 2000Mi | No | Memory limit for the container |
| CD_EPHEMERAL_STORAGE_LIMITS | 5Gi | No | Ephemeral storage limit for the container |
| CD_CPU_REQUESTS | 500m | No | CPU request for the container |
| CD_MEM_REQUESTS | 2000Mi | No | Memory request for the container |
| CD_EPHEMERAL_STORAGE_REQUESTS | 3Gi | No | Ephemeral storage request for the container |