Loading a PPA package to ICP
This topic describes how to load the PPA package to IBM Cloud Private (ICP).
To load PPA packages to ICP, you need the following items:
- IBM Cloud CLI. (Download from ICP > Command Line Tool).
- Bluemix Cloud Private Plugin. (Download from ICP > Command Line Tool).
- The PPA package containing chart(s) and docker image(s).
- Setup Docker (See https://www.ibm.com/support/knowledgecenter/SSBS6K_2.1.0.3/manage_images/configuring_docker_cli.html). Note: The Docker version to be used should be at least equal to or higher than the Docker used on ICP. See: https://www.ibm.com/support/knowledgecenter/SSBS6K_2.1.0.3/supported_system_config/supported_docker.htmll
The loading process consists of the following steps:
- Login to your ICP cluster. The following commands are for ICP 2.1.0.2 and 2.1.0.3, which is TLS
enabled by default. (Replace
<MasterNode_IP>with the IP address of the master node.)$ bx pr login -a <MasterNode_IP> --skip-ssl-validation API endpoint: <MasterNode_IP> Authenticating... OK Select an account: 1. mycluster Account (id-mycluster-account) Enter a number> 1 Targeted account: mycluster Account (id-mycluster-account) - Initialize the
bx prtool with the latest config after logging in.bx pr cluster-config mycluster Configuring kubectl: /Users/azmand/.bluemix/plugins/icp/clusters/mycluster/kube-config Cluster "mycluster" set. Cluster "mycluster" set. User "mycluster-user" set. Context "mycluster-context" modified. Context "mycluster-context" modified. Switched to context "mycluster-context". OK Cluster mycluster configured successfully. - Login to docker with your cluster admin Service Account credentials. The default cluster admin
account is
admin/admin.$ docker login mycluster.icp:8500 - Load the PPA package.Note: The commands and output that follow are an example. You must update parameters such as archive, clustername, and namespace with the correct values for your ICP cluster and archive name.
$ bx pr load-ppa-archive --archive ibm-cloud-netcool-probe-2.8.2-x86_64.tar.gz --clustername mycluster.icp --namespace default Creating temporary directory OK Expanding archive OK Reading manifest OK Importing docker images Processing image: netcool-probe-messagebus:8.0 Loading Image Tagging Image Pushing image as: mycluster.icp:8500/default/netcool-probe-messagebus:8.0 Pushing image mycluster.icp:8500/default/netcool-probe-messagebus:8.0 OK Uploading helm charts Processing chart: charts/ibm-netcool-probe-2.0.0.tgz Updating chart values.yaml Uploading chart {"url":"https://icp-management-ingress:8443/helm-repo/charts/index.yaml"} OK Synch charts {"message":"synch started"} OK