Oracle® Linux

Oracle Container Runtime for Docker User's Guide

Oracle Legal Notices
Oracle Documentation License


January 2020

Table of Contents

1 About Oracle Container Runtime for Docker
1.1 Technical Preview Releases
1.2 Notable Updates
1.2.1 Oracle Container Runtime for Docker 19.03
1.2.2 Oracle Container Runtime for Docker 18.09
1.2.3 Oracle Container Runtime for Docker 18.03
1.2.4 Oracle Container Runtime for Docker 17.06
1.2.5 Docker 17.03
1.2.6 Docker 1.12
2 Installing Oracle Container Runtime for Docker
2.1 Setting up Unbreakable Enterprise Kernel
2.2 Enabling Access to the Oracle Container Runtime for Docker Packages
2.3 Removing the docker Package
2.4 Installing Oracle Container Runtime for Docker
2.5 Configuring a Proxy Server
2.6 Configuring IPv6 Networking
2.7 Configuring Docker Storage
2.7.1 Configuring Docker Storage Automatically
2.7.2 Configuring Docker Storage Manually
2.7.3 Configuring a Docker Storage Driver
2.8 Excluding Docker Container Files from locate Output
3 Upgrading Oracle Container Runtime for Docker
3.1 Upgrade Preqrequisites
3.1.1 Updating the Unbreakable Enterprise Kernel
3.1.2 Checking the Storage Driver
3.2 Upgrading the Docker Engine
4 Managing the Docker Engine Service
4.1 Configuring the Docker Engine Service
4.2 Reloading or Restarting the Docker Engine
4.3 Enabling Non-root Users to Run Docker Commands
4.4 Configuring User Namespace Remapping
4.5 Enabling Live Restore for Containers
4.6 Setting Container Registry Options
4.6.1 Adding Registries
4.6.2 Blocking Registries
4.6.3 Setting the Default Registry
4.6.4 Adding Insecure Registries
5 Working with Containers and Images
5.1 Pulling Oracle Linux Images from a Container Registry
5.1.1 Enabling or Disabling Docker Content Trust
5.2 Creating and Running Docker Containers
5.2.1 Configuring How Docker Restarts Containers
5.2.2 Controlling Capabilities and Making Host Devices Available to Containers
5.2.3 Accessing the Host's Process ID Namespace
5.2.4 Mounting a Host's root File System in Read-Only Mode
5.3 Creating a Docker Image from an Existing Container
5.4 Creating a Docker Image from a Dockerfile
5.5 Creating Multi-stage Docker Image Builds
5.6 About Docker Networking
5.6.1 About Multihost Networking
5.7 Communicating Between Docker Containers
5.8 Accessing External Files from Docker Containers
5.9 Creating and Using Data Volume Containers
5.10 Moving Data Between Docker Containers and the Host
5.11 Using Labels to Define Metadata
5.12 Defining the Logging Driver
5.13 About Image Digests
5.14 Specifying Control Groups for Containers
5.15 Limiting CPU Usage by Containers
5.16 Making a Container Use the Host's UTS Namespace
5.17 Setting ulimit Values on Containers
5.18 Building Images with Resource Constraints
5.19 Committing, Exporting and Importing Images
6 Using Docker Registries
6.1 Pulling Images from the Oracle Container Registry
6.2 Pulling Licensed Software from the Oracle Container Registry
6.3 Using the Oracle Container Registry Mirrors
6.4 Using the Docker Hub
6.5 Setting up a Local Docker Registry
6.5.1 Creating a Registry File System
6.5.2 Setting up Transport Layer Security for the Docker Registry
6.5.3 Creating the Registry
6.5.4 Setting up the Registry Port
6.5.5 Distributing X.509 Certificates
6.5.6 Importing Images into a Registry
7 For More Information About Docker
8 Known Issues
8.1 WARNING: bridge-nf-call-iptables is disabled
8.2 Starting the Docker Engine with User Namespace Remapping set to default can fail
8.3 Issue pulling aarch64 images from Oracle Container Registry