Docker EE for IBM Cloud setup & prerequisitesEstimated reading time: 3 minutes
Docker Enterprise Edition (EE) for IBM Cloud
Docker EE for IBM Cloud is an unmanaged, native Docker environment within IBM Cloud that runs Docker Enterprise Edition software. Docker EE for IBM Cloud is available on December 20th 2017 as a closed Beta.
Email IBM to request access to the closed beta. In the welcome email you receive, you are given the Docker EE installation URL that you use for the beta.
To create a swarm cluster in IBM Cloud, you must have certain accounts, credentials, and environments set up.
If you do not have an IBM Cloud account, register for a Pay As You Go IBM Cloud account.
If you already have an IBM Cloud account, make sure that you can provision infrastructure resources. You might need to upgrade or link your account.
For a full list of infrastructure permissions, see What IBM Cloud infrastructure permissions do I need?. In general you must be able to provision the following types of resources:
- File and block storage.
- Load balancers.
- SSH keys.
- Subnet IPs.
- Virtual server devices.
Log in to IBM Cloud infrastructure, select your user profile, and under the API Access Information section retrieve your API Username and Authentication Key.
If you have not already, create an organization and space in IBM Cloud. You must be the account owner or administrator to complete this step.
Install the CLIs
To use Docker EE for IBM Cloud, you need the following CLIs:
- IBM Cloud CLI version.
- Docker for IBM Cloud plug-in.
- Optional: IBM Cloud Container Registry plug-in.
Install the IBM Cloud CLI.
Log in to the IBM Cloud CLI. Enter your credentials when prompted. If you have a federated ID, use the
$ bx login [--sso]
Install the Docker EE for IBM Cloud plug-in. The prefix for running commands is
$ bx plugin install docker-for-ibm-cloud -r Bluemix
Optional: To manage a private IBM Cloud Container Registry, install the plug-in. The prefix for running commands is
$ bx plugin install container-registry -r Bluemix
Verify that the plug-ins have been installed properly:
$ bx plugin list
Set infrastructure environment variables
The Docker EE for IBM Cloud CLI plug-in simplifies your interaction with IBM Cloud infrastructure resources. As such, many
bx d4ic commands require you to provide your infrastructure account user name and API key credentials.
Instead of including these in each command, you can set your environment variables.
Under the API Access Information section, locate your API Username and Authentication Key.
Retrieve your Docker EE installation URL. For beta, you received this in your welcome email.
From the CLI, set the environment variables with your infrastructure credentials and your Docker EE installation URL:
export SOFTLAYER_USERNAME=user.name.1234567 export SOFTLAYER_API_KEY=my_authentication_key export D4IC_DOCKER_EE_URL=my_docker-ee-url
Verify that your environment variables were set.
$ env | grep SOFTLAYER && env | grep D4IC_DOCKER_EE_URL SOFTLAYER_API_KEY=my_authentication_key SOFTLAYER_USERNAME=user.name.1234567 D4IC_DOCKER_EE_URL=my_docker-ee-url
- Create a swarm.
- Access UCP and the download client certificate bundle.
- Learn when to use UCP and the CLIs.
- Configure DTR to use IBM Cloud Object Storage.