adding note about running install and upgrade commands pointing toward private registry for air gap

This commit is contained in:
Mark Bishop
2018-05-24 17:06:26 -07:00
committed by Mark Bishop
parent 21c4549fc8
commit eda8d3cc1e
4 changed files with 42 additions and 2 deletions
@@ -36,6 +36,16 @@ We will cover two scenarios:
5. Complete installation of Rancher using the instructions in [Single Node Install]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install/).
>**Note:**
> When completing [Single Node Install]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install/), you must prepend your private registry URL to the server tag that you use for installation.
>
> Example:
> ```
docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
<registry.yourdomain.com:port>rancher/rancher:latest
```
#### Scenario 2: You have one host that can access both DockerHub and your private registry.
![Scenario2]({{< baseurl >}}/img/rancher/airgap/privateregistrypushpull.svg)
@@ -55,7 +65,17 @@ for IMAGE in $IMAGES; do
docker push registry.yourdomain.com:5000/$IMAGE
done
```
3. Complete installation of Rancher using the instructions in [Single Node Install]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install/).
3. Complete installation of Rancher using the instructions in [Single Node Install]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install/).
>**Note:**
> When completing [Single Node Install]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install/), you must prepend your private registry URL to the server tag that you use for installation.
>
> Example:
> ```
docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
<registry.yourdomain.com:port>rancher/rancher:latest
```
### Configuring Rancher to use the private registry
@@ -4,8 +4,11 @@ weight: 250
---
For development environments, we recommend installing Rancher by running a single Docker container. In this installation scenario, you'll install Docker on a single Linux host, and then install Rancher on your host using a single Docker container.
>**Note:**
> If you want to use an external load balancer, see [Single Node Installation with an External Loadbalancer]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install-external-lb/).
> If you want to use an external load balancer, see [Single Node Installation with an External Loadbalancer]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install-external-lb)
>
## Overview
@@ -43,6 +46,12 @@ For security purposes, SSL (Secure Sockets Layer) is required when using Rancher
Choose from the following options:
>**Attention Air Gap Users:**
> If you are visiting this page to complete [Air Gap Installation]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap-installation/), you must prepend your private registry URL to the server tag when running the installation command in the option that you choose.
>
> Example: `<registry.yourdomain.com:port>/rancher/rancher:latest`
>
- [Option A-Default Self-Signed Certificate](#option-a-default-self-signed-certificate)
- [Option B-Bring Your Own Certificate: Self-Signed](#option-b-bring-your-own-certificate-self-signed)
- [Option C-Bring Your Own Certificate: Signed by Recognized CA](#option-c-bring-your-own-certificate-signed-by-recognized-ca)
@@ -9,3 +9,8 @@ To upgrade an air gapped Rancher Server, update your private registry with the l
1. Follow the directions in [Air Gap Installation]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap-installation/) to update the images required for the version of Rancher you want to upgrade to.
2. Follow the directions in [Single Node Upgrade]({{< baseurl >}}/rancher/v2.x/en/upgrades/single-node-upgrade/) to complete upgrade of your air gapped Rancher Server.
>**Note:**
> While completing [Single Node Upgrade]({{< baseurl >}}/rancher/v2.x/en/upgrades/single-node-upgrade/), you must prepend your private registry URL to the server tag when running the upgrade command.
>
> Example: `<registry.yourdomain.com:port>/rancher/rancher:latest`
@@ -33,6 +33,12 @@ docker create --volumes-from <RANCHER_CONTAINER_ID> \
docker pull rancher/rancher:latest
```
>**Attention Air Gap Users:**
> If you are visiting this page to complete [Air Gap Upgrade]({{< baseurl >}}/rancher/v2.x/en/installation/air-gap-upgrade/), you must prepend your private registry URL to the server tag when running the upgrade command.
>
> Example: `<registry.yourdomain.com:port>/rancher/rancher:latest`
>
4. Launch a new Rancher Server container using the `rancher-data` container.
```