Skip to content

Commit 3dca765

Browse files
committed
docs: Update to openshift-install 0.8.0
A few changes: * Backticks for some code like ~/Downloads/pull-secret. This change is not exhaustive. * Drop environment variables to catch up with openshift/installer@6be4c253 (*: remove support for environment variables, 2018-12-10, openshift/installer#861). * Link to the installer repository for a list of supported platforms. * Link to the installer repository for discussion of repeat calls, since that seems useful, but out-of-scope for a workshop-length introduction.
1 parent a3a88cc commit 3dca765

File tree

2 files changed

+12
-54
lines changed

2 files changed

+12
-54
lines changed

docs/01-prerequisites.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,28 +4,25 @@
44

55
1. Visit [https://try.openshift.com](https://try.openshift.com) with your web browser
66
1. Login with a Red Hat Account
7-
1. Download the Pull Secret to location on host (e.g. ~/Downloads/pull-secret)
7+
1. Download the Pull Secret to a location on your host (e.g. `~/Downloads/pull-secret`)
88
1. Download the Installer release for your platform
99
1. Download Terraform
1010
1. Download OpenShift client tools
1111

1212
### Linux
1313

14-
```
15-
wget https://github.com/openshift/installer/releases/download/v0.4.0/openshift-install-linux-amd64
14+
```sh
15+
wget https://github.com/openshift/installer/releases/download/v0.8.0/openshift-install-linux-amd64
1616
chmod u+x ./openshift-install-linux-amd64
17-
export OPENSHIFT_INSTALL_PULL_SECRET_PATH=~/Downloads/pull-secret
18-
curl -L "https://releases.hashicorp.com/terraform/0.11.8/terraform_0.11.8_linux_amd64.zip" | funzip terraform
1917
wget https://mirror.openshift.com/pub/openshift-v3/clients/4.0.0-0.79.0/linux/oc.tar.gz
2018
tar -xvf oc.tar.gz
2119
```
2220

2321
### Mac
2422

2523
```
26-
curl -O -L https://github.com/openshift/installer/releases/download/v0.4.0/openshift-install-darwin-amd64
24+
curl -O -L https://github.com/openshift/installer/releases/download/v0.8.0/openshift-install-darwin-amd64
2725
chmod +x ./openshift-install-darwin-amd64
28-
export OPENSHIFT_INSTALL_PULL_SECRET_PATH=~/Downloads/pull-secret
2926
curl -L https://releases.hashicorp.com/terraform/0.11.8/terraform_0.11.8_darwin_amd64.zip | funzip terraform
3027
```
3128

docs/02-install.md

Lines changed: 8 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ cannot determine on its own and providing reasonable defaults for everything
77
else. For more advanced users, the installer provides facilities for varying
88
levels of customization.
99

10-
In [supported environments](#supported-environments), the installer is also
10+
In [supported environments][supported-environments], the installer is also
1111
capable of provisioning the underlying infrastructure for the cluster. It is
1212
recommended that most users make use of this functionality in order to avoid
1313
having to provision their own infrastructure. In unsupported environments or
@@ -20,9 +20,8 @@ installer.
2020

2121
In the prior step, we downloaded the following:
2222

23-
1. installer (e.g. openshift-install-linux-amd64)
24-
1. pull secret
25-
1. configured env var for OPENSHIFT_PULL_SECRET_PATH
23+
1. installer (e.g. `openshift-install-linux-amd64`)
24+
1. pull secret (e.g. `~/Downloads/pull-secret`)
2625

2726
## Wizard
2827

@@ -80,49 +79,11 @@ INFO kubeadmin user password: Seiv2-q9xJW-2rHR2-UGRRj
8079
INFO Install complete! The kubeconfig is located here: /home/decarr/go/src/github.com/openshift/installer/auth/kubeconfig
8180
```
8281

83-
## Populated Answers
82+
## Multiple Invocations
8483

85-
If you want to avoid the wizard, its useful to setup a set of env vars for a
86-
particular cloud platform.
87-
88-
### Amazon Web Services
89-
90-
#### Linux
91-
92-
```
93-
## location of previously downloaded pull secret
94-
export OPENSHIFT_INSTALL_PULL_SECRET_PATH=~/Downloads/pull-secret
95-
## location of SSH public key
96-
export OPENSHIFT_INSTALL_SSH_PUB_KEY_PATH=~/.ssh/id_rsa.pub
97-
export OPENSHIFT_INSTALL_PLATFORM=aws
98-
99-
## name of cluster
100-
export OPENSHIFT_INSTALL_CLUSTER_NAME=my-cluster
101-
export OPENSHIFT_INSTALL_PASSWORD=my-password
102-
export OPENSHIFT_INSTALL_AWS_REGION=us-east-2
103-
export OPENSHIFT_INSTALL_BASE_DOMAIN=devcluster.example.com
104-
./openshift-install-linux-amd64 create cluster
105-
```
106-
107-
#### Mac
108-
109-
```
110-
## location of previously downloaded pull secret
111-
export OPENSHIFT_INSTALL_PULL_SECRET_PATH=~/Downloads/pull-secret
112-
## location of SSH public key
113-
export OPENSHIFT_INSTALL_SSH_PUB_KEY_PATH=~/.ssh/id_rsa.pub
114-
export OPENSHIFT_INSTALL_PLATFORM=aws
115-
116-
## name of cluster
117-
export OPENSHIFT_INSTALL_CLUSTER_NAME=my-cluster
118-
export OPENSHIFT_INSTALL_PASSWORD=my-password
119-
export OPENSHIFT_INSTALL_AWS_REGION=us-east-2
120-
export OPENSHIFT_INSTALL_BASE_DOMAIN=devcluster.example.com
121-
./openshift-install-darwin-amd64 create cluster
122-
```
123-
124-
## Supported Environments
125-
126-
- AWS
84+
If you want to avoid the wizard in future runs, you can [save the generated `install-config.yaml` and reuse it later][multiple-invocations].
12785

12886
Next: [Exploring the Cluster](03-explore.md)
87+
88+
[multiple-invocations]: https://github.com/openshift/installer/blob/master/docs/user/overview.md#multiple-invocations
89+
[supported-environments]: https://github.com/openshift/installer/blob/master/README.md#supported-platforms

0 commit comments

Comments
 (0)