PowerVC-Tool

Useful tool to create and check OpenShift clusters on IBM Cloud PowerVC

CLI opitons:

• create-bastion
• create-cluster
• create-rhcos
• watch-create
• watch-installation

create-bastion

This will create an HAProxy VM which will act as an OpenShift Load Balancer. This VM will be managed by another instance of this program with the watch-installation parameter.

NOTE: The environment variable IBMCLOUD_API_KEY is optional. If not set, make sure DNS is supported via CoreOS DNS or another method.

Example usage:

$ PowerVC-Tool create-bastion --cloud ${cloud_name} --bastionName ${bastion_name} --flavorName ${flavor_name} --imageName ${image_name} --networkName ${network_name} --sshKeyName ${ssh_keyname} --domainName ${domain_name} --shouldDebug true

args:

• cloud the name of the cloud to use in the ~/.config/openstack/clouds.yaml file.

• bastionName The name of the VM to use which should match the OpenShift cluster name.

• flavorName The OpenStack flavor to create the VM with.

• imageName The OpenStack image to create the VM with.

• networkName The OpenStack network to create the VM with.

• sshKeyName The OpenStack ssh keyname to create the VM with.

• domainName The DNS domain name for the bastion. (optional)

• shouldDebug defauts to false. This will cause the program to output verbose debugging information.

create-cluster

This was a development tool used during the initial investigation. It takes a powervc install-config.yaml, converts it to a openstack configuration, calls the IPI installer, and then converts the generated files to work on a PowerVC setup.

Example usage:

$ PowerVC-Tool create-cluster --directory ${directory} --shouldDebug true

args:

• directory location to use the IPI installer

• shouldDebug defauts to false. This will cause the program to output verbose debugging information.

create-rhcos

This will create a test RHCOS VM. This VM will be managed by another instance of this program with the watch-installation parameter.

NOTE: The environment variable IBMCLOUD_API_KEY is optional. If not set, make sure DNS is supported via CoreOS DNS or another method.

Example usage:

$ PowerVC-Tool create-rhcos --cloud ${cloud_name} --rhcosName ${rhcos_name} --flavorName ${flavor_name} --imageName ${image_name} --networkName ${network_name} --sshPublicKey $(cat ${HOME}/.ssh/id_installer_rsa.pub) --domainName ${domain_name} --shouldDebug true

args:

• cloud the name of the cloud to use in the ~/.config/openstack/clouds.yaml file.

• rhcosName The name of the VM to use which should match the OpenShift cluster name.

• flavorName The OpenStack flavor to create the VM with.

• imageName The OpenStack image to create the VM with.

• networkName The OpenStack network to create the VM with.

• sshPublicKey The OpenStack ssh keyname to create the VM with.

• domainName The DNS domain name for the bastion. (optional)

• shouldDebug defauts to false. This will cause the program to output verbose debugging information.

watch-create

NOTE: The environment variable IBMCLOUD_API_KEY needs to be set.

Example usage:

$ PowerVC-Tool watch-create --metadata ${directory}/metadata.json --kubeconfig ${directory}/auth/kubeconfig --cloud ${cloud_name} --bastionUsername ${bastion_username} --bastionRsa ${HOME}/.ssh/id_installer_rsa --baseDomain ${domain_name} --cisInstanceCRN ${ibmcloud_cis_crn} --shouldDebug false

args:

• metadata the location of the metadata.json file created by the IPI OpenShift installer.

• kubeconfig the location of the kubeconfig file created by the IPI OpenShift installer.

• cloud the name of the cloud to use in the ~/.config/openstack/clouds.yaml file.

• bastionUsername the default username for the HAProxy VM.

• bastionRsa the SSH private key file for the default username for the HAProxy VM.

• baseDomain the domain name of the OpenShift cluster.

• cisInstanceCRN the CRN of the IBM Cloud CIS DNS instance.

• shouldDebug defauts to false. This will cause the program to output verbose debugging information.

watch-installation

This is for checking the progress of an ongoing openshift-install create cluster operation of the OpenShift IPI installer. Run this in another window while the installer deploys a cluster.

NOTE: The environment variable IBMCLOUD_API_KEY is optional. If not set, make sure DNS is supported via CoreOS DNS or another method.

Example usage:

$ PowerVC-Tool watch-installation --cloud ${cloud_name} --domainName ${domain_name} --bastionMetadata ${directory}/metadata.json --bastionUsername ${bastion_username} --bastionRsa ${HOME}/.ssh/id_installer_rsa --dhcpSubnet ${dhcp_subnet} --dhcpNetmask ${dhcp_netmask} --dhcpRouter ${dhcp_router} --dhcpDnsServers "${dhcp_servers}" --shouldDebug true

args:

• cloud the name of the cloud to use in the ~/.config/openstack/clouds.yaml file.

• domainName the domain name to use for the OpenShift cluster.

• bastionMetadata the location of the metadata.json file created by the IPI OpenShift installer. This parameter can have more than one occurance.

• bastionUsername the default username for the HAProxy VM.

• bastionRsa the SSH private key file for the default username for the HAProxy VM.

• dhcpSubnet The subnet to use for DHCPd requests.

• dhcpNetmask The netmask to use for DHCPd requests.

• dhcpRouter The router to use for DHCPd requests.

• dhcpDnsServers The comma separated DNS servers to use for DHCPd requests.

• shouldDebug defauts to false. This will cause the program to output verbose debugging information.

Useful scripts

scripts/create-cluster.sh

Required environment variables before running this script:

• IBMCLOUD_API_KEY the IBM Cloud API key. @TODO-necessary?

• BASEDOMAIN the domain name to use for the OpenShift cluster.

• BASTION_IMAGE_NAME the OpenStack image name for the HAProxy VM.

• BASTION_USERNAME the default username for the HAProxy VM.

• CLOUD the name of the cloud to use in the ~/.config/openstack/clouds.yaml file.

• CLUSTER_DIR the directory location where the OpenShift IPI installer will save important files.

• CLUSTER_NAME the name prefix to use for the OpenShift cluster which you are installing.

• FLAVOR_NAME the OpenStack flavor name to use for OpenShift VMs.

• MACHINE_TYPE the PowerPC machine type to use for OpenShift VMs.

• NETWORK_NAME the OpenStack network name to use for OpenShift VMs.

• RHCOS_IMAGE_NAME the OpenStack image name to use for OpenShift VMs.

• SSHKEY_NAME the OpenStack ssh keyname to use for the HAProxy VM.

Required existing files before running this script:

• ~/.pullSecretCompact

• ~/.ssh/id_installer_rsa.pub

Required existing binaries before running this script:

• openshift-install The OpenShift IPI installer.

• openstack The OpenStack CLI tool existing on Fedora/RHEL/CentOS repositories.

• jq The JSON query CLI tool found at https://jqlang.org/download/ and existing on Fedora/RHEL/CentOS repositories.