Skip to content

Commit db1db8d

Browse files
committed
Adding new slackernews tutorials
1 parent 7045768 commit db1db8d

File tree

2 files changed

+85
-0
lines changed

2 files changed

+85
-0
lines changed
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# Tutorial: Automate Installation with Embedded Cluster
2+
3+
This tutorial shows how to install a release using Embedded Cluster from the command line without using the Admin Console UI. This is also known as a _headless_ installation.
4+
5+
## Set Up
6+
7+
Get access to a VM.
8+
9+
## Tutorial
10+
11+
1. Create an app.
12+
13+
1. Get the release files and Helm chart archive.
14+
15+
1. Add the files to a new release with `replicated release create --yaml-dir manifests --promote Unstable`.
16+
17+
1. Create a customer with Embedded Cluster installation.
18+
19+
1. If you are using Compatibility Matrix, create the VM:
20+
21+
1. Create the VM
22+
1. Create the DNS records.
23+
24+
1. SSH onto your VM.
25+
26+
1. Download the installation assets and untar. You can add these commands to CI/CD workflows to automate this step.
27+
28+
1. Create the ConfigValues file:
29+
30+
```yaml
31+
apiVersion: kots.io/v1beta1
32+
kind: ConfigValues
33+
spec:
34+
values:
35+
slackernews_domain:
36+
value: YOUR_DOMAIN
37+
```
38+
Where `YOUR_DOMAIN` is the domain to use for SlackerNews. For Compatibility Matrix VMs, this is the hostname provided for the DNS record you created with port 443.
39+
40+
1. Transfer the ConfigValues to your VM using scp.
41+
42+
1. Run the following command to install:
43+
44+
1. Open a shell to watch the application resources deploy.
45+
46+
1. `sudo ./APP_SLUG shell`
47+
48+
1. `kubectl get all --namespace slackernews`
49+
50+
1. Go to the domain that you listed for the SlackerNews to open the application.

docs/vendor/tutorial-helm-cli.mdx

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Tutorial: Install with the Helm CLI
2+
3+
This tutorial shows how to install a release using the Helm CLI.
4+
5+
## Set Up
6+
7+
Get access to a cluster.
8+
9+
## Tutorial
10+
11+
1. Create an app.
12+
13+
1. Get the Helm chart archive.
14+
15+
1. Add the Replicated SDK.
16+
17+
1. Add preflights.
18+
19+
1. Add the chart to a new release with `replicated release create --yaml-dir . --promote Unstable`.
20+
21+
1. Create a customer with Helm CLI installation option enabled.
22+
23+
1. If you are using Compatibility Matrix, create the cluster.
24+
25+
1. Use the command provided to set your kubectl context to the cluster.
26+
27+
1. Go to the Enterprise Portal for the customer.
28+
29+
1. Follow instructions to install in the cluster.
30+
31+
1. Run `kubectl get all -n slackernews` to see when services are running
32+
33+
1. Run `kubectl port-forward --namespace slackernews svc/slackernews-nginx 8080:80` to port forward
34+
35+
1. Open `localhost:8080` in a browser.

0 commit comments

Comments
 (0)