Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Docker image version for Plus #2302

Merged
merged 1 commit into from
Dec 21, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions docs/content/app-protect/installation.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Installation with NGINX App Protect
description:
description:
weight: 1800
doctypes: [""]
toc: true
Expand All @@ -22,20 +22,20 @@ Take the steps below to either configure a Docker Registry secret in your Kubern

For NGINX Plus Ingress Controller with App Protect, pull from `private-registry.nginx.com/nginx-ic-nap/nginx-plus-ingress`:
```
$ docker pull private-registry.nginx.com/nginx-ic-nap/nginx-plus-ingress:1.12.0
$ docker pull private-registry.nginx.com/nginx-ic-nap/nginx-plus-ingress:2.0.3
```
`1.12.0` will pull down the Debian based image. The other available image tag is `1.12.0-ubi` for the UBI based image.
`2.0.3` will pull down the Debian based image. The other available image tag is `2.0.3-ubi` for the UBI based image.

- Use the docker registry API to list the available image tags for the repository.

To list the available image tags for the repository, you can use the Docker registry API, e.g.:
```
$ curl https://private-registry.nginx.com/v2/nginx-ic-nap/nginx-plus-ingress/tags/list --key <path-to-client.key> --cert <path-to-client.cert> | jq
{
"name": "nginx-ic-nap/nginx-plus-ingress",
"tags": [
"1.12.0-ubi",
"1.12.0"
"2.0.3-ubi",
"2.0.3"
]
}
```
Expand Down
20 changes: 10 additions & 10 deletions docs/content/installation/pulling-ingress-controller-image.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Pulling the Ingress Controller Image
description:
description:
weight: 1700
doctypes: [""]
toc: true
Expand All @@ -20,7 +20,7 @@ Before you can pull the image, make sure that the following software is installe

## Pulling the Image using Docker and Pushing It to the Private Registry

1. First, configure the Docker environment to use certificate-based client-server authentication with the F5 Container registry - `private-registry.nginx.com`.
1. First, configure the Docker environment to use certificate-based client-server authentication with the F5 Container registry - `private-registry.nginx.com`.
To do so in a Linux based environment, create a `private-registry.nginx.com` directory under `/etc/docker/certs.d` and create a certificate `client.cert` (using `nginx-repo.crt` - please note that the certificate MUST have the `.cert` suffix, not `.crt`) and a key `client.key` (using `nginx-repo.key`). See [this document](https://docs.docker.com/engine/security/certificates/) for more details.

```
Expand All @@ -34,14 +34,14 @@ Before you can pull the image, make sure that the following software is installe
2. Use docker to pull the required image from `private-registry.nginx.com`. Choose the image from the available images listed [here](nginx-ingress-controller/technical-specifications/#images-with-nginx-plus).
For NGINX Plus Ingress Controller, pull from `private-registry.nginx.com/nginx-ic/nginx-plus-ingress`, e.g.:
```
$ docker pull private-registry.nginx.com/nginx-ic/nginx-plus-ingress:1.12.0
$ docker pull private-registry.nginx.com/nginx-ic/nginx-plus-ingress:2.0.3
```

For NGINX Plus Ingress Controller with App Protect, pull from `private-registry.nginx.com/nginx-ic-nap/nginx-plus-ingress`, e.g.:
```
$ docker pull private-registry.nginx.com/nginx-ic-nap/nginx-plus-ingress:1.12.0
$ docker pull private-registry.nginx.com/nginx-ic-nap/nginx-plus-ingress:2.0.3
```

To list the available image tags for the repositories, you can also use the Docker registry API, e.g.:
```
$ curl https://private-registry.nginx.com/v2/nginx-ic/nginx-plus-ingress/tags/list --key <path-to-client.key> --cert <path-to-client.cert> | jq
Expand All @@ -68,12 +68,12 @@ Before you can pull the image, make sure that the following software is installe
3. Tag and push the image to your private registry.
Make sure to run the `docker login` command first to log in to the registry.
```
$ docker tag private-registry.nginx.com/nginx-ic/nginx-plus-ingress:1.12.0 <my-docker-registry>/nginx-ic/nginx-plus-ingress:1.12.0
$ docker push <my-docker-registry>/nginx-ic/nginx-plus-ingress:1.12.0
$ docker tag private-registry.nginx.com/nginx-ic/nginx-plus-ingress:2.0.3 <my-docker-registry>/nginx-ic/nginx-plus-ingress:2.0.3
$ docker push <my-docker-registry>/nginx-ic/nginx-plus-ingress:2.0.3
```

or for NGINX App Protect enabled image
```
$ docker tag private-registry.nginx.com/nginx-ic-nap/nginx-plus-ingress:1.12.0 <my-docker-registry>/nginx-ic-nap/nginx-plus-ingress:1.12.0
$ docker push <my-docker-registry>/nginx-ic-nap/nginx-plus-ingress:1.12.0
$ docker tag private-registry.nginx.com/nginx-ic-nap/nginx-plus-ingress:2.0.3 <my-docker-registry>/nginx-ic-nap/nginx-plus-ingress:2.0.3
$ docker push <my-docker-registry>/nginx-ic-nap/nginx-plus-ingress:2.0.3
```