mirror of https://github.com/docker/docs.git
Engine 18.03 (#6948)
* Improve description for multiple tiers * Update EE engine installation * Add release notes for engine 18.03.1-ee-1
This commit is contained in:
parent
4c5f0ab7a6
commit
dde14cad56
|
@ -201,7 +201,7 @@ To manually install Docker EE, download the `.{{ package-format | downcase }}` f
|
||||||
|
|
||||||
{% if linux-dist == "centos" %}
|
{% if linux-dist == "centos" %}
|
||||||
1. Go to the Docker EE repository URL associated with your trial or subscription
|
1. Go to the Docker EE repository URL associated with your trial or subscription
|
||||||
in your browser. Go to `{{ linux-dist-url-slug }}/7/x86_64/stable-{{ site.docker_ee_version }}/Packages`
|
in your browser. Go to `{{ linux-dist-url-slug }}/7/x86_64/stable-<VERSION>/Packages`
|
||||||
and download the `.{{ package-format | downcase }}` file for the Docker version you want to install.
|
and download the `.{{ package-format | downcase }}` file for the Docker version you want to install.
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
|
@ -19,6 +19,29 @@ it references. However, Docker EE also includes back-ported fixes
|
||||||
defect fixes that you can use in environments where new features cannot be
|
defect fixes that you can use in environments where new features cannot be
|
||||||
adopted as quickly for consistency and compatibility reasons.
|
adopted as quickly for consistency and compatibility reasons.
|
||||||
|
|
||||||
|
## 18.03.1-ee-1 (2018-06-27)
|
||||||
|
|
||||||
|
> Important notes about this release
|
||||||
|
>
|
||||||
|
> If you're deploying UCP or DTR, use Docker EE Engine 17.06.
|
||||||
|
{: .important}
|
||||||
|
|
||||||
|
### Client
|
||||||
|
|
||||||
|
+ Update to docker-ce 18.03.1 client.
|
||||||
|
+ Add `docker trust` command for image signing and enabling the secure supply chain from development to deployment.
|
||||||
|
+ Add docker compose on Kubernentes.
|
||||||
|
|
||||||
|
### Runtime
|
||||||
|
|
||||||
|
+ Update to docker-ce 18.03.1 engine.
|
||||||
|
+ Add support for FIPS 140-2 on x86_64.
|
||||||
|
+ Add support for Microsoft Windows Server 1709.
|
||||||
|
+ Add support for Microsoft Windows Server 1803.
|
||||||
|
+ Windows opt-out telemetry stream.
|
||||||
|
+ Support for `--chown` with `COPY` and `ADD` in `Dockerfile`.
|
||||||
|
+ Add support for multiple logging drivers for `docker logs`.
|
||||||
|
|
||||||
## 17.06.2-ee-14 (2018-06-21)
|
## 17.06.2-ee-14 (2018-06-21)
|
||||||
|
|
||||||
### Client
|
### Client
|
||||||
|
|
|
@ -15,13 +15,39 @@ and supported to provide enterprises with the most secure container platform
|
||||||
in the industry. For more info about Docker EE, including purchasing
|
in the industry. For more info about Docker EE, including purchasing
|
||||||
options, see [Docker Enterprise Edition](https://www.docker.com/enterprise-edition/).
|
options, see [Docker Enterprise Edition](https://www.docker.com/enterprise-edition/).
|
||||||
|
|
||||||
<!-- This is populated by logic in js/archive.js -->
|
There are currently two versions of Docker EE Engine available:
|
||||||
<p id="ee-version-div"></p>
|
|
||||||
|
* 18.03 - Use this version if you're only running Docker EE Engine.
|
||||||
|
* 17.06 - Use this version if you're using Docker Enterprise Edition 2.0 (Docker
|
||||||
|
Engine, UCP, and DTR).
|
||||||
|
|
||||||
## Docker EE tiers
|
## Docker EE tiers
|
||||||
|
|
||||||
{% include docker_ce_ee.md %}
|
{% include docker_ce_ee.md %}
|
||||||
|
|
||||||
|
### Enterprise Edition Basic
|
||||||
|
|
||||||
|
With Docker EE Basic, you can deploy Docker Enterprise Engine
|
||||||
|
to manage your container workloads in a flexible way. You can manage workloads
|
||||||
|
on Windows, Linux, on-premise or on the cloud.
|
||||||
|
|
||||||
|
Docker EE Basic has enterprise class support with defined SLAs, extended
|
||||||
|
maintenance cycles for patches for up to 24 months.
|
||||||
|
|
||||||
|
[Learn more about the supported platforms](#supported-platforms).
|
||||||
|
|
||||||
|
### Enterprise Edition Standard and Advanced
|
||||||
|
|
||||||
|
Docker EE Standard has everything the Basic edition has, and extends it with
|
||||||
|
private image management, integrated image signing policies, and cluster
|
||||||
|
management with support for Kubernetes and Swarm orchestrators.
|
||||||
|
|
||||||
|
Docker EE Advanced takes this one step further and allows you to implement
|
||||||
|
node-based RBAC policies, image promotion policies, image mirroring, and
|
||||||
|
scan your images for vulnerabilities.
|
||||||
|
|
||||||
|
[Learn more about Docker EE Standard and Advanced](/ee/index.md).
|
||||||
|
|
||||||
## Supported platforms
|
## Supported platforms
|
||||||
|
|
||||||
The following table shows all of the platforms that are available for Docker EE.
|
The following table shows all of the platforms that are available for Docker EE.
|
||||||
|
@ -65,16 +91,10 @@ and third-party ecosystem solution briefs.
|
||||||
|
|
||||||
## Docker Enterprise Edition release cycles
|
## Docker Enterprise Edition release cycles
|
||||||
|
|
||||||
Docker EE is released quarterly. Releases use a time-based versioning
|
Each Docker EE release is supported and maintained for 24 months, and
|
||||||
scheme, so for example, Docker EE version 17.03 was released
|
|
||||||
in March 2017. For schedule details, see
|
|
||||||
[Time-based release schedule](/engine/installation/#time-based-release-schedule).
|
|
||||||
|
|
||||||
Each Docker EE release is supported and maintained for one year and
|
|
||||||
receives security and critical bug fixes during this period.
|
receives security and critical bug fixes during this period.
|
||||||
|
|
||||||
The Docker API version is independent of the Docker platform version. The API
|
The Docker API version is independent of the Docker platform version. We maintain
|
||||||
version doesn't change from Docker 1.13.1 to Docker 17.03. We maintain
|
|
||||||
careful API backward compatibility and deprecate APIs and features slowly and
|
careful API backward compatibility and deprecate APIs and features slowly and
|
||||||
conservatively. We remove features after deprecating them for a period of
|
conservatively. We remove features after deprecating them for a period of
|
||||||
three stable releases. Docker 1.13 introduced improved interoperability
|
three stable releases. Docker 1.13 introduced improved interoperability
|
||||||
|
|
|
@ -27,7 +27,7 @@ This section lists what you need to consider before installing Docker EE. Items
|
||||||
- Find the URL for your Docker EE repo at [Docker Store](https://store.docker.com/my-content){: target="_blank" class="_" }.
|
- Find the URL for your Docker EE repo at [Docker Store](https://store.docker.com/my-content){: target="_blank" class="_" }.
|
||||||
- Uninstall old versions of Docker.
|
- Uninstall old versions of Docker.
|
||||||
- Remove old Docker repos from `/etc/yum.repos.d/`.
|
- Remove old Docker repos from `/etc/yum.repos.d/`.
|
||||||
- Disable SELinux if installing or upgrading Docker EE 17.06.1.
|
- Disable SELinux if installing or upgrading Docker EE 17.06.1 or newer.
|
||||||
|
|
||||||
### Architectures and storage drivers
|
### Architectures and storage drivers
|
||||||
|
|
||||||
|
@ -56,7 +56,7 @@ $ sudo yum remove docker \
|
||||||
{% capture selinux-warning %}
|
{% capture selinux-warning %}
|
||||||
> Docker EE cannot install on {{ linux-dist-long }} with SELinux enabled
|
> Docker EE cannot install on {{ linux-dist-long }} with SELinux enabled
|
||||||
>
|
>
|
||||||
> If you have `selinux` enabled and you attempt to install Docker EE 17.06.1, you get an error that the `container-selinux` package cannot be found..
|
> If you have `selinux` enabled and you attempt to install Docker EE 17.06.1 or newer, you get an error that the `container-selinux` package cannot be found..
|
||||||
{:.warning}
|
{:.warning}
|
||||||
{% endcapture %}
|
{% endcapture %}
|
||||||
{{ selinux-warning }}
|
{{ selinux-warning }}
|
||||||
|
|
|
@ -36,15 +36,10 @@ Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
|
||||||
To learn more about Docker EE, see
|
To learn more about Docker EE, see
|
||||||
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
|
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
|
||||||
|
|
||||||
### OS requirements
|
### System requirements
|
||||||
|
|
||||||
To install Docker EE, you need the 64-bit version of one of these Ubuntu versions:
|
To learn more about software requirements and supported storage drivers,
|
||||||
|
check the [compatibility matrix](https://success.docker.com/article/compatibility-matrix).
|
||||||
- Xenial 16.04 (LTS)
|
|
||||||
- Trusty 14.04 (LTS)
|
|
||||||
|
|
||||||
Docker EE is supported on `x86_64` (or `amd64`), `s390x` (IBM Z), and `ppc64el`
|
|
||||||
(IBM Power) architectures.
|
|
||||||
|
|
||||||
### Uninstall old versions
|
### Uninstall old versions
|
||||||
|
|
||||||
|
@ -60,29 +55,20 @@ It's OK if `apt-get` reports that none of these packages are installed.
|
||||||
The contents of `/var/lib/docker/`, including images, containers, volumes, and
|
The contents of `/var/lib/docker/`, including images, containers, volumes, and
|
||||||
networks, are preserved. The Docker EE package is now called `docker-ee`.
|
networks, are preserved. The Docker EE package is now called `docker-ee`.
|
||||||
|
|
||||||
### Supported storage drivers
|
|
||||||
|
|
||||||
Docker EE on Ubuntu supports `overlay2` and `aufs` storage drivers.
|
|
||||||
|
|
||||||
- For new installations on version 4 and higher of the Linux kernel, `overlay2`
|
|
||||||
is supported and preferred over `aufs`.
|
|
||||||
- For version 3 of the Linux kernel, `aufs` is supported because `overlay` or
|
|
||||||
`overlay2` drivers are not supported by that kernel version.
|
|
||||||
|
|
||||||
If you need to use `aufs`, you need to do additional preparation as
|
|
||||||
outlined below.
|
|
||||||
|
|
||||||
#### Extra steps for aufs
|
#### Extra steps for aufs
|
||||||
|
|
||||||
|
If your version supports the `aufs` storage driver, you need some preparation
|
||||||
|
before installing Docker.
|
||||||
|
|
||||||
<ul class="nav nav-tabs">
|
<ul class="nav nav-tabs">
|
||||||
<li class="active"><a data-toggle="tab" data-target="#aufs_prep_xenial">Xenial 16.04 and newer</a></li>
|
<li class="active"><a data-toggle="tab" data-target="#aufs_prep_xenial">Xenial 16.04 or higher</a></li>
|
||||||
<li><a data-toggle="tab" data-target="#aufs_prep_trusty">Trusty 14.04</a></li>
|
<li><a data-toggle="tab" data-target="#aufs_prep_trusty">Trusty 14.04</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
<div class="tab-content">
|
<div class="tab-content">
|
||||||
<div id="aufs_prep_xenial" class="tab-pane fade in active" markdown="1">
|
<div id="aufs_prep_xenial" class="tab-pane fade in active" markdown="1">
|
||||||
|
|
||||||
For Ubuntu 16.04 and higher, the Linux kernel includes support for OverlayFS,
|
For Ubuntu 16.04 and higher, the Linux kernel includes support for overlay2,
|
||||||
and Docker CE uses the `overlay2` storage driver by default. If you need
|
and Docker EE uses it as the default storage driver. If you need
|
||||||
to use `aufs` instead, you need to configure it manually.
|
to use `aufs` instead, you need to configure it manually.
|
||||||
See [aufs](/engine/userguide/storagedriver/aufs-driver.md)
|
See [aufs](/engine/userguide/storagedriver/aufs-driver.md)
|
||||||
|
|
||||||
|
@ -149,7 +135,18 @@ from the repository.
|
||||||
$ DOCKER_EE_URL="<DOCKER-EE-URL>"
|
$ DOCKER_EE_URL="<DOCKER-EE-URL>"
|
||||||
```
|
```
|
||||||
|
|
||||||
4. Add Docker's official GPG key using your customer Docker EE repository URL:
|
4. Temporarily add a `$DOCKER_EE_VERSION` variable into your environment.
|
||||||
|
There are currently two versions of Docker EE Engine available:
|
||||||
|
|
||||||
|
* `stable-18.03` - Use this version if you're only running Docker EE Engine.
|
||||||
|
* `stable-17.06` - Use this version if you're using Docker Enterprise Edition (Docker
|
||||||
|
Engine, UCP, and DTR).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ DOCKER_EE_VERSION=<YOUR_VERSION>
|
||||||
|
```
|
||||||
|
|
||||||
|
5. Add Docker's official GPG key using your customer Docker EE repository URL:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
$ curl -fsSL "${DOCKER_EE_URL}/ubuntu/gpg" | sudo apt-key add -
|
$ curl -fsSL "${DOCKER_EE_URL}/ubuntu/gpg" | sudo apt-key add -
|
||||||
|
@ -169,7 +166,7 @@ from the repository.
|
||||||
sub 4096R/6D085F96 2017-02-22
|
sub 4096R/6D085F96 2017-02-22
|
||||||
```
|
```
|
||||||
|
|
||||||
5. Use the following command to set up the **stable** repository. Use the
|
6. Use the following command to set up the **stable** repository. Use the
|
||||||
command as-is. It works because of the variable you set earlier.
|
command as-is. It works because of the variable you set earlier.
|
||||||
|
|
||||||
> **Note**: The `lsb_release -cs` sub-command below returns the name of your
|
> **Note**: The `lsb_release -cs` sub-command below returns the name of your
|
||||||
|
@ -188,7 +185,7 @@ from the repository.
|
||||||
$ sudo add-apt-repository \
|
$ sudo add-apt-repository \
|
||||||
"deb [arch=amd64] $DOCKER_EE_URL/ubuntu \
|
"deb [arch=amd64] $DOCKER_EE_URL/ubuntu \
|
||||||
$(lsb_release -cs) \
|
$(lsb_release -cs) \
|
||||||
stable-{{ site.docker_ee_version }}"
|
$DOCKER_EE_VERSION"
|
||||||
```
|
```
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
@ -198,7 +195,7 @@ from the repository.
|
||||||
$ sudo add-apt-repository \
|
$ sudo add-apt-repository \
|
||||||
"deb [arch=s390x] $DOCKER_EE_URL/ubuntu \
|
"deb [arch=s390x] $DOCKER_EE_URL/ubuntu \
|
||||||
$(lsb_release -cs) \
|
$(lsb_release -cs) \
|
||||||
stable-{{ site.docker_ee_version }}"
|
$DOCKER_EE_VERSION"
|
||||||
```
|
```
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
@ -208,7 +205,7 @@ from the repository.
|
||||||
$ sudo add-apt-repository \
|
$ sudo add-apt-repository \
|
||||||
"deb [arch=ppc64el] $DOCKER_EE_URL/ubuntu \
|
"deb [arch=ppc64el] $DOCKER_EE_URL/ubuntu \
|
||||||
$(lsb_release -cs) \
|
$(lsb_release -cs) \
|
||||||
stable-{{ site.docker_ee_version }}"
|
$DOCKER_EE_VERSION"
|
||||||
```
|
```
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
@ -299,7 +296,7 @@ a new file each time you want to upgrade Docker EE.
|
||||||
|
|
||||||
1. Go to the Docker EE repository URL associated with your
|
1. Go to the Docker EE repository URL associated with your
|
||||||
trial or subscription in your browser. Go to
|
trial or subscription in your browser. Go to
|
||||||
`ubuntu/x86_64/stable-{{ site.docker_ee_version }}` and download the `.deb` file for the
|
`ubuntu/x86_64/stable-<VERSION>` and download the `.deb` file for the
|
||||||
Docker EE version and architecture you want to install.
|
Docker EE version and architecture you want to install.
|
||||||
|
|
||||||
2. Install Docker EE, changing the path below to the path where you downloaded
|
2. Install Docker EE, changing the path below to the path where you downloaded
|
||||||
|
@ -353,5 +350,4 @@ You must delete any edited configuration files manually.
|
||||||
## Next steps
|
## Next steps
|
||||||
|
|
||||||
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md).
|
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md).
|
||||||
|
|
||||||
- Continue with the [User Guide](/engine/userguide/index.md).
|
- Continue with the [User Guide](/engine/userguide/index.md).
|
||||||
|
|
|
@ -7,36 +7,18 @@ redirect_from:
|
||||||
- /engine/installation/windows/docker-ee/
|
- /engine/installation/windows/docker-ee/
|
||||||
---
|
---
|
||||||
|
|
||||||
{% capture filename %}{{ page.win_latest_build }}.zip{% endcapture %}
|
|
||||||
{% capture download_url %}https://download.docker.com/components/engine/windows-server/{{ site.docker_ee_version }}/{{ filename }}{% endcapture %}
|
|
||||||
|
|
||||||
|
|
||||||
Docker Enterprise Edition for Windows Server (*Docker EE*) enables native
|
Docker Enterprise Edition for Windows Server (*Docker EE*) enables native
|
||||||
Docker containers on Windows Server. Windows Server 2016 and later versions are supported. The Docker EE installation package
|
Docker containers on Windows Server. Windows Server 2016 and later versions are supported. The Docker EE installation package
|
||||||
includes everything you need to run Docker on Windows Server.
|
includes everything you need to run Docker on Windows Server.
|
||||||
This topic describes pre-install considerations, and how to download and
|
This topic describes pre-install considerations, and how to download and
|
||||||
install Docker EE.
|
install Docker EE.
|
||||||
|
|
||||||
>**Looking for Release Notes?** [Get release notes for all
|
> Release notes
|
||||||
versions here](/release-notes/) or subscribe to the
|
>
|
||||||
[releases feed on the Docker Blog](http://blog.docker.com/category/engineering/docker-releases/).
|
> You can [get release notes for all versions here](/release-notes/)
|
||||||
|
|
||||||
## Docker Universal Control Plane and Windows
|
|
||||||
|
|
||||||
With Docker EE, your Windows nodes can join swarms that are managed
|
|
||||||
by Docker Universal Control Plane (UCP). When you have Docker EE installed
|
|
||||||
on Windows Server 2016 or 1709 and you have a
|
|
||||||
[UCP manager node provisioned](/ee/ucp/admin/install/), you can
|
|
||||||
[join your Windows worker nodes to a swarm](/ee/ucp/admin/configure/join-nodes/join-windows-nodes-to-cluster/).
|
|
||||||
|
|
||||||
## Install Docker EE
|
## Install Docker EE
|
||||||
|
|
||||||
>Windows Server 1803
|
|
||||||
>
|
|
||||||
>Docker Universal Control Plane is not currently supported on Windows Server 1803 due to image incompatibility issues.
|
|
||||||
>To use UCP, for now, use the current LTSB Windows release or Windows Server 1709 as UCP Workers.
|
|
||||||
|
|
||||||
|
|
||||||
Docker EE for Windows requires Windows Server 2016 or later. See
|
Docker EE for Windows requires Windows Server 2016 or later. See
|
||||||
[What to know before you install](#what-to-know-before-you-install) for a
|
[What to know before you install](#what-to-know-before-you-install) for a
|
||||||
full list of prerequisites.
|
full list of prerequisites.
|
||||||
|
@ -75,7 +57,6 @@ full list of prerequisites.
|
||||||
|
|
||||||
Hello from Docker!
|
Hello from Docker!
|
||||||
This message shows that your installation appears to be working correctly.
|
This message shows that your installation appears to be working correctly.
|
||||||
<snip>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### (optional) Make sure you have all required updates
|
### (optional) Make sure you have all required updates
|
||||||
|
@ -90,60 +71,6 @@ sconfig
|
||||||
|
|
||||||
Select option `6) Download and Install Updates`.
|
Select option `6) Download and Install Updates`.
|
||||||
|
|
||||||
## Use a script to install Docker EE
|
|
||||||
|
|
||||||
Use the following steps when you want to install manually, script automated
|
|
||||||
installs, or install on air-gapped systems.
|
|
||||||
|
|
||||||
1. In a PowerShell command prompt, download the installer archive on a machine
|
|
||||||
that has a connection.
|
|
||||||
|
|
||||||
```PowerShell
|
|
||||||
# On an online machine, download the zip file.
|
|
||||||
invoke-webrequest -UseBasicparsing -Outfile {{ filename }} {{ download_url }}
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Copy the zip file to the machine where you want to install Docker. In a
|
|
||||||
PowerShell command prompt, use the following commands to extract the archive,
|
|
||||||
register, and start the Docker service.
|
|
||||||
|
|
||||||
```PowerShell
|
|
||||||
#Stop Docker service
|
|
||||||
Stop-Service docker
|
|
||||||
|
|
||||||
# Extract the archive.
|
|
||||||
Expand-Archive {{ filename }} -DestinationPath $Env:ProgramFiles -Force
|
|
||||||
|
|
||||||
# Clean up the zip file.
|
|
||||||
Remove-Item -Force {{ filename }}
|
|
||||||
|
|
||||||
# Install Docker. This requires rebooting.
|
|
||||||
$null = Install-WindowsFeature containers
|
|
||||||
|
|
||||||
# Add Docker to the path for the current session.
|
|
||||||
$env:path += ";$env:ProgramFiles\docker"
|
|
||||||
|
|
||||||
# Optionally, modify PATH to persist across sessions.
|
|
||||||
$newPath = "$env:ProgramFiles\docker;" +
|
|
||||||
[Environment]::GetEnvironmentVariable("PATH",
|
|
||||||
[EnvironmentVariableTarget]::Machine)
|
|
||||||
|
|
||||||
[Environment]::SetEnvironmentVariable("PATH", $newPath,
|
|
||||||
[EnvironmentVariableTarget]::Machine)
|
|
||||||
|
|
||||||
# Register the Docker daemon as a service.
|
|
||||||
dockerd --register-service
|
|
||||||
|
|
||||||
# Start the Docker service.
|
|
||||||
Start-Service docker
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Test your Docker EE installation by running the `hello-world` container.
|
|
||||||
|
|
||||||
```PowerShell
|
|
||||||
docker container run hello-world:nanoserver
|
|
||||||
```
|
|
||||||
|
|
||||||
## Install a specific version
|
## Install a specific version
|
||||||
|
|
||||||
To install a specific Docker version, you can use the
|
To install a specific Docker version, you can use the
|
||||||
|
|
|
@ -50,9 +50,5 @@ if (window.navigator.onLine) {
|
||||||
});
|
});
|
||||||
} else {
|
} else {
|
||||||
isArchive = false;
|
isArchive = false;
|
||||||
/* This is only relevant to /enterprise/index.md */
|
|
||||||
if (document.getElementById('ee-version-div')) {
|
|
||||||
document.getElementById('ee-version-div').textContent += "The latest version of Docker EE Engine is {{ site.docker_ee_version }}.";
|
|
||||||
}
|
|
||||||
} });
|
} });
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in New Issue