edits

paigecalvert · paigecalvert · commit 58c8442c8561 · 2025-09-17T15:12:47.000-06:00
diff --git a/docs/vendor/tutorial-helm-cli.mdx b/docs/vendor/tutorial-helm-cli.mdx
@@ -86,17 +86,29 @@ Before you begin, do the following to set up your environment:
 
        Setting the `REPLICATED_APP` environment variable allows you to interact with the application using the Replicated CLI without needing to use the `--app` flag with every command.
 
-## Get the Chart Archive and Create a Release       
+### Get the Chart Archive and Create a Release       
 
 1. Run the following command to download the SlackerNews Helm chart archive to a new `tutorial-helm-install` directory: 
 
     ```
     curl -O --create-dirs --output-dir tutorial-helm-install https://docs.replicated.com/slackernews-1.0.1.tgz
     ```
 
-1. Add the chart to a new release with `replicated release create --yaml-dir tutorial-helm-install --promote Unstable`.
+1. Add the chart archive to a new release:
 
-## Create a Customer
+   ```bash
+   replicated release create --yaml-dir tutorial-helm-install --promote Unstable
+   ```
+   **Example output:**
+   ```
+   • Reading manifests from . ✓
+   • Creating Release ✓
+    • SEQUENCE: 1
+   • Promoting ✓
+    • Channel 32q8tKLfRFbHYPGJ1Q2E2vcDQ9j successfully set to release 1
+   ```
+
+### Create a Customer
 
 1. Log in to the [Vendor Portal](https://vendor.replicated.com).
 
@@ -124,7 +136,7 @@ Before you begin, do the following to set up your environment:
 
 1. Click **Save Changes**.
 
-## Access the Enterprise Portal
+### Access the Enterprise Portal
 
 1. On the customer's page, go to the **Enterprise Portal Access** tab.
 
@@ -168,146 +180,50 @@ Before you begin, do the following to set up your environment:
 
       ![installation guide landing page](/images/enterprise-portal-installation-guide.png)
 
-    [View a larger version of this image](/images/enterprise-portal-installation-guide.png)
+      [View a larger version of this image](/images/enterprise-portal-installation-guide.png)
 
 1. For instance name, enter a nickname for the instance.
 
-1. For **Kubernetes Distribution**, select the distribution of your cluster where you will install SlackerNews.
+1. For **Kubernetes Distribution**, select the distribution of your cluster where you will install SlackerNews. (If you are going to use Compatibility Matrix to create the cluster, select **Vanilla Kubernetes**).
 
 1. For **Cluster Network Availability**, select **Outbound requests allowed**.
 
 1. For **Registry Access**, select **My workstation can access the internet, the registry AND the cluster**.
 
 1. Click **Next**.
 
-## Create the Values File
+### Install    
 
-1. Create a Helm values file to pass to the chart during installation:
+1. If you brouhgt your own cluster, set kubectl context to the cluster where you want to install. If you are using Compatibility Matrix, do the following:
 
-    ```bash
-    touch my-values.yaml
-    ```
-1. In the `my-values.yaml` file, copy and paste the following YAML:
-
-        <details>
-          <summary>View `my-values.yaml`</summary>
-          ```yaml
-          postgres:
-            # tells slackernews to use postgres as the
-            # backing database instead of sqlite
-            enabled: false
-            # deploys a postgresql workload to the cluster
-            deploy_postgres: false
-            # the password to use with deploy_postgres
-            password: ""
-            # if deploy_postgres is false, provide a URI
-            uri: ""
-            # use a value in an existing secret instead of
-            # .postgres.password OR .postgres.uri
-            existingSecretName: ""
-            # key in the secret that contains the password
-            existingSecretPasswordKey: ""
-            # key in the secret that contains the uri
-            existingSecretUriKey: ""
-            # service type if deploy_postgres is true
-            service:
-              type: ClusterIP
-              nodePort:
-                port:
-            sqlite:
-              enabled: true
-            ingress:
-              annotations: {}
-              enabled: false
-              ingressClassName: ""
-            nginx:
-              service:
-                type: ClusterIP
-                nodePort:
-                  port:
-            service:
-              tls:
-                enabled: false
-                existingSecretName: ""
-                existingSecretCertKey: ""
-                existingSecretKeyKey: ""
-                cert: ""
-                key: ""
-            slack:
-              clientId: ""
-              clientSecret: ""
-              userToken: ""
-              botToken: ""
-              existingSecretName: ""
-              existingSecretClientIdKey: ""
-              existingSecretClientSecretKey: ""
-              existingSecretUserTokenKey: ""
-              existingSecretBotTokenKey: ""
-            slackernews:
-              domain: ""
-              # set default admin users
-              adminUserEmails: ""
-              # display running version on admin dashboard
-              version: "$TAG"
-            replicated:
-              isEmbeddedCluster: false
-              image:
-                registry: registry.replicated.com
-                repository: library/replicated-sdk-image
-                tag: 1.8.0
-            images:
-              pullSecrets:
-                - name: slackernews-pull-secret
-              slackernews:
-                registry: us-docker.pkg.dev
-                repository: smart-proxy-839/slackernews/slackernews-web
-                tag: v1.0.36
-                pullPolicy: IfNotPresent
-              nginx:
-                registry: index.docker.io
-                repository: library/nginx
-                tag: 1.28.0
-                pullPolicy: IfNotPresent
-              postgres:
-                registry: index.docker.io
-                repository: library/postgres
-                tag: 16
-                pullPolicy: IfNotPresent
-          ```
-        </details>
-
-1. In the `slackernews.domain` field, enter a hostname.
-
-    This is a required value for the application. For the purpose of this tutorial, the value that you provide does not need to be a real hostname. You will use a port forward to access SlackerNews in a browser after installation.
-
-    ```yaml
-    # my-values.yaml
-    slackernews:
-      domain: "somedomain"
-    ```
+   1. Create a kind cluster with version 1.34.0 of Kubernetes:
 
-## Install    
+      ```bash
+      replicated cluster create --distribution kind --instance-type r1.small --disk 50 --version 1.34.0
+      ```
 
-1. Set kubectl context to the cluster where you want to install. If you are using Compatibility Matrix, do the following:
+   1. After the cluster is running, use the kubectl command provided to set your kubectl context to the cluster.
 
-    1. Create a kind cluster with version 1.34.0 of Kubernetes:
+1. In the Enterprise Portal, for **Helm Online Install**, select the release version that you promoted (`1.0.1`).
 
-       ```bash
-       replicated cluster create --distribution kind --instance-type r1.small --disk 50 --version 1.34.0
-       ```
-
-    1. After the cluster is running, use the kubectl command provided to set your kubectl context to the cluster.
+1. Run the first command to log in to the Replicated registry.
 
-1. In the Enterprise Portal, for **Helm Online Install**, select the release version that you promoted (`0.0.1`).
+1. Run the commands to install the preflight plugin and then run preflight checks in the cluster.
 
-1. Copy and run the first command to log in to the Replicated registry.
+1. Copy the install command and make the following changes:
+   * Remove the `--values my-values.yaml` flag. This is not necessary for the purpose of this tutorial because you do not need to pass a local values file to the chart.
+   * Add `--namespace slackernews --create-namespace` to install the application to the slackernews namespace on the cluster
 
-1. Copy and run the commands to install and run preflight checks in the cluster.
+1. Watch the application resources become available: 
 
-1. Run the install command to install SlackerNews in your cluster using the Helm CLI. Ensure that the path provided with the `--values` flag points to the `my-values.yaml` file that you created.
+    ```bash
+    kubectl get all --namespace slackernews --watch
+    ```
 
-1. Run `kubectl get all -n slackernews` to see when services are running
+1. Run the following command to port forward the slackernews NGINX service to local port 8080:
 
-1. Run `kubectl port-forward --namespace slackernews svc/slackernews-nginx 8080:80` to port forward
+   ```bash
+   kubectl port-forward --namespace slackernews svc/slackernews-nginx 8080:8080
+   ``` 
 
-1. Open `localhost:8080` in a browser.
+1. Open `localhost:8080` in a browser to view the SlackerNews application and confirm that the installation was successful.
