Skip to content

Commit

Permalink
merge pull request #89 from zackbradys/main
Browse files Browse the repository at this point in the history
standardized example references
  • Loading branch information
zackbradys authored Mar 29, 2024
2 parents 705e65d + efc4067 commit 91303c4
Show file tree
Hide file tree
Showing 5 changed files with 27 additions and 22 deletions.
6 changes: 3 additions & 3 deletions docs/airgapped-docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,8 +57,8 @@ If you're working with a cluster that was imported or is to be imported into the
# /etc/rancher/k3s/registries.yaml
# /etc/rancher/rke2/registries.yaml
configs:
"YOUR_REGISTRY_HOSTNAME":
"<registry-url>":
auth:
username: YOUR_REGISTRY_USERNAME
password: YOUR_REGISTRY_PASSWORD
username: <redacted>
password: <redacted>
```
8 changes: 4 additions & 4 deletions docs/registry-docs/kubernetes-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ The full configuration using your authenticated registry is below:
```yaml
# /etc/rancher/k3s/registries.yaml
configs:
"YOUR_REGISTRY_DOMAIN_HERE":
"<registry-url>":
auth:
username: <redacted>
password: <redacted>
Expand All @@ -20,7 +20,7 @@ configs:
You will also need to utilize the `system-default-registry` flag when installing K3s to ensure it uses the registry. For instance:

```bash
curl -sfL https://get.k3s.io | sh -s - --system-default-registry=<YOUR_REGISTRY_DOMAIN_HERE>
curl -sfL https://get.k3s.io | sh -s - --system-default-registry=<registry-url>
```

### Usage with `rke2`
Expand All @@ -32,7 +32,7 @@ The full configuration using the shared alpha account is below:
```yaml
# /etc/rancher/rke2/registries.yaml
configs:
"YOUR_REGISTRY_DOMAIN_HERE":
"<registry-url>":
auth:
username: <redacted>
password: <redacted>
Expand All @@ -44,6 +44,6 @@ You will also need to utilize the `system-default-registry` flag when installing
# /etc/rancher/rke2/config.yaml
node-name: controlplane1
write-kubeconfig-mode: 0640
system-default-registry: YOUR_REGISTRY_DOMAIN_HERE
system-default-registry: <registry-url>
...
```
27 changes: 16 additions & 11 deletions docs/registry-docs/rancher-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,23 +31,28 @@ After adding the Cert Manager repo and installing the CRDs, use the following to
```
cat <<EOT > /tmp/cert-manager-values.yaml
image:
registry: YOUR_REGISTRY_DOMAIN_HERE
registry: <registry-url>
repository: jetstack/cert-manager-controller
webhook:
image:
registry: YOUR_REGISTRY_DOMAIN_HERE
registry: <registry-url>
repository: jetstack/cert-manager-webhook
cainjector:
image:
registry: YOUR_REGISTRY_DOMAIN_HERE
registry: <registry-url>
repository: jetstack/cert-manager-cainjector
startupapicheck:
image:
registry: YOUR_REGISTRY_DOMAIN_HERE
repository: jetstack/cert-manager-ctl
registry: <registry-url>
repository: jetstack/cert-manager-startupapicheck
acmesolver:
image:
registry: <registry-url>
repository: jetstack/cert-manager-acmesolver
EOT
```

Expand Down Expand Up @@ -99,10 +104,10 @@ The full configuration using the shared alpha account is below:
mirrors:
docker.io:
endpoint:
- 'https://YOUR_REGISTRY_DOMAIN'
- "https://<registry-url>"

configs:
'YOUR_REGISTRY_DOMAIN':
"<registry-url>":
auth:
username: <redacted>
password: <redacted>
Expand Down Expand Up @@ -131,8 +136,8 @@ helm install rancher carbide-charts/rancher \
--namespace cattle-system \
--set hostname=rancher.my.org \
--set replicas=3 \
--set rancherImage=YOUR_REGISTRY_DOMAIN/rancher/rancher
--set systemDefaultRegistry=YOUR_REGISTRY_DOMAIN
--set rancherImage=<registry-url>/rancher/rancher
--set systemDefaultRegistry=<registry-url>
```

**NOTE:** This requires configuring your above K3s/RKE2 `registries.yaml` to work.
Expand All @@ -150,10 +155,10 @@ write_files:
mirrors:
docker.io:
endpoint:
- "https://YOUR_REGISTRY_DOMAIN"
- "https://<registry-url>"
configs:
"YOUR_REGISTRY_DOMAIN":
"<registry-url>":
auth:
username: <redacted>
password: <redacted>
Expand Down
2 changes: 1 addition & 1 deletion docs/registry-docs/uninstall-kubernetes.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ You will also need to unset the `system-default-registry` configuration when ins
For instance, if you originally ran the following when using Carbide images:

```bash
curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="server --flannel-backend none" K3S_TOKEN=12345 sh - --system-default-registry YOUR_REGISTRY_DOMAIN_HERE
curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="server --flannel-backend none" K3S_TOKEN=12345 sh - --system-default-registry <registry-url>
```

You'd need to run:
Expand Down
6 changes: 3 additions & 3 deletions docs/stigatron-docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,8 +58,8 @@ If you're working with a cluster that was imported or is to be imported into the
# /etc/rancher/k3s/registries.yaml
# /etc/rancher/rke2/registries.yaml
configs:
"YOUR_REGISTRY_HOSTNAME":
"<registry-url>":
auth:
username: YOUR_REGISTRY_USERNAME
password: YOUR_REGISTRY_PASSWORD
username: <redacted>
password: <redacted>
```

0 comments on commit 91303c4

Please sign in to comment.