6.4 Using the Docker Hub

The Docker Hub contains Docker images for licensed commercial Oracle software products that you may use in your enterprise. The Docker Hub is at:

https://hub.docker.com

You are able to browse the Docker Hub, but to access the images hosted there, you must log in with a valid Docker ID. If you do not have a Docker ID, you can register at:

https://hub.docker.com/signup

The Docker Hub provides a web interface that allows you to select the Docker Certified images that you want to install, and to agree to any terms and conditions that may apply, or to make payment if required.

When you have agreed to the terms and conditions that apply to an image, the image is stored in the My Content area, so that you can revisit it later.

Each image provides a description and set up instructions. You may need to log into Docker Hub before you are able to pull an image. Failure to do so generates an error notifying you that the image does not exist or that you have no pull access, for example:

# docker pull store/oracle/database-enterprise:12.2.0.1
Trying to pull repository docker.io/store/oracle/database-enterprise ... 
pull access denied for store/oracle/database-enterprise, repository does not exist or may 
require 'docker login': denied: requested access to the resource is denied

The Docker Hub requires that you are logged in before you can pull any images hosted in this registry. This makes sure the terms and conditions that apply to the image have been accepted, and that any payments have been settled. The following example illustrates how you can log into the Docker Hub, and pull an image:

# docker login
Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, 
head over to https://hub.docker.com to create one.
Username: username
Password: 
Login Succeeded
# docker pull store/oracle/database-enterprise:12.2.0.1
Trying to pull repository docker.io/store/oracle/database-enterprise ... 
12.2.0.1: Pulling from docker.io/store/oracle/database-enterprise
4ce27fe12c04: Pull complete 
9d3556e8e792: Pull complete 
fc60a1a28025: Pull complete 
0c32e4ed872e: Pull complete 
b465d9b6e399: Downloading  340.7MB/2.739GB