Sept marketplace release (#6585)

* Nomad Cluster deployment guide
* Nomad Clients Cluster deployment guide

---------

Co-authored-by: Matt Wildman <[email protected]>
Co-authored-by: John Dutton <[email protected]>

docs/products/tools/marketplace/guides/hashicorp-nomad-clients-cluster/index.md

@@ -0,0 +1,60 @@
+---
+description: "Deploy HashiCorp Nomad Clients Cluster, a flexible scheduling and orchestration for diverse workloads, on Linode Compute Instances.'"
+keywords: ['HashiCorp','Nomad','Scheduling', 'orchestration']
+tags: ["marketplace", "linode platform", "cloud manager"]
+published: 2023-09-12
+modified_by:
+  name: Linode
+title: "Deploy HashiCorp Nomad Clients Cluster through the Linode Marketplace"
+authors: ["Linode"]
+---
+
+The [HashiCorp Nomad](https://www.nomadproject.io/) Clients Cluster deploys 3, 5 or 7 Compute Instances as clients to horizontally scale an *existing HashiCorp Nomad Cluster*. The plan type and size you select is applied to each individual instance.
+
+See our guide on deploying a [HashiCorp Nomad Cluster](/docs/products/tools/marketplace/guides/hashicorp-nomad-cluster/) if you have not already deployed a cluster.
+
+{{< note >}}
+Please be aware that each Compute Instance will appear on your invoice as a separate item. If you would rather deploy HashiCorp Nomad on a single Compute Instance, see [Deploy Hashicorp Nomad through the Linode Marketplace](/docs/products/tools/marketplace/guides/hashicorp-nomad/).
+{{< /note >}}
+
+## Deploying a Marketplace App
+
+{{< content "deploy-marketplace-apps-shortguide">}}
+
+{{< content "marketplace-verify-standard-shortguide">}}
+
+{{< note >}}
+**Estimated deployment time:** Nomad Clients Cluster should be fully installed within 15-20 minutes after the Compute Instances have finished provisioning.
+{{< /note >}}
+
+## Configuration Options
+
+- **Supported distributions**: Ubuntu 22.04 LTS
+- **Recommended plan**: Nomad clients can be of any size.
+- **Region**: The region you select should be the same as your existing Nomad Cluster.
+
+{{< content "marketplace-special-character-limitations-shortguide">}}
+
+### Nomad Client Options
+
+- **Linode API Token** *(required)*: Your API token is used to deploy additional Compute Instances as part of this cluster. At a minimum, this token must have Read/Write access to *Linodes*. If you do not yet have an API token, see [Get an API Access Token](/docs/products/tools/api/guides/manage-api-tokens/) to create one.
+
+- **Limited sudo user** *(required)*: A limited user account with sudo access is created as part of this cluster deployment. Enter your preferred username for this limited user. Please note that the password is automatically created.
+
+- **consul_nomad_autojoin_token generated by Nomad Server OCC** *(required)*: This token is generated by the [HashiCorp Nomad Cluster](/docs/products/tools/marketplace/guides/hashicorp-nomad-cluster/) deployment and can be found in the `~/.deployment_secrets.txt` file created in your original cluster.
+
+- **Add Account SSH Keys to All Nodes?** If you select *yes*, any SSH Keys that are added to the root user account (in the **SSH Keys** section), are also added to your limited user account on all deployed Compute Instances.
+
+- **Nomad Client Count:** Select the preferred number of additional cluster clients from the available options (3, 5 or 7).
+
+## Getting Started after Deployment
+
+### Accessing the Nomad Web UI
+
+After deployment, you can confirm your clients have been successfully added to your cluster by logging into the Nomad Web UI and selecting **Clients** on the left sidebar. *Nomad clients are not interacted with directly*.
+
+![Screenshot of Nomad Web UI Clients tab](NomadClientsTab.jpg)
+
+Please see [HashiCorp Nomad Cluster](/docs/products/tools/marketplace/guides/hashicorp-nomad-cluster/) for information on accessing the Nomad Web UI and managing your cluster.
+
+{{< content "marketplace-update-note-shortguide">}}

docs/products/tools/marketplace/guides/hashicorp-nomad-cluster/index.md

@@ -0,0 +1,99 @@
+---
+description: "Deploy HashiCorp Nomad Cluster, a flexible scheduling and orchestration for diverse workloads, on Linode Compute Instances.'"
+keywords: ['HashiCorp','Nomad','Scheduling', 'orchestration']
+tags: ["marketplace", "linode platform", "cloud manager"]
+published: 2023-09-11
+modified_by:
+  name: Linode
+title: "Deploy HashiCorp Nomad Cluster through the Linode Marketplace"
+authors: ["Linode"]
+---
+
+[HashiCorp Nomad](https://www.nomadproject.io/) is a workload scheduler and orchestrator that allows you to deploy and manage containerized or non-containerized, legacy applications using a single, unified workflow. Nomad uses bin packaging for efficient job scheduling and resource optimization, as well as enables developers to use declarative infrastructure-as-code for their deployments.
+
+{{< note type="warning" title="Marketplace App Cluster Notice" >}}
+This Marketplace App deploys 6 Compute Instances to create a highly available, redundant Hashicorp Nomad Cluster. The plan type and size you select is applied to each individual instance.
+
+Please be aware that each Compute Instance will appear on your invoice as a separate item. If you would rather deploy Hashicorp Nomad on a single Compute Instance, see [Deploy Hashicorp Nomad through the Linode Marketplace](/docs/products/tools/marketplace/guides/hashicorp-nomad/).
+
+**Note:** There can only be one Marketplace Nomad Cluster per datacenter.
+{{< /note >}}
+
+## Deploying a Marketplace App
+
+{{< content "deploy-marketplace-apps-shortguide">}}
+
+{{< content "marketplace-verify-standard-shortguide">}}
+
+{{< note >}}
+**Estimated deployment time:** Nomad Cluster should be fully installed within 15-20 minutes after the Compute Instances have finished provisioning.
+{{< /note >}}
+
+## Configuration Options
+
+- **Supported distributions:** Ubuntu 22.04 LTS
+- **Recommended plan:** We recommend 8GB Dedicated CPU or 8GB Shared CPU instances for the Nomad Cluster.
+
+{{< content "marketplace-special-character-limitations-shortguide">}}
+
+### Nomad Cluster Options
+
+- **Linode API Token** *(required)*: Your API token is used to deploy additional Compute Instances as part of this cluster. At a minimum, this token must have Read/Write access to *Linodes*. If you do not yet have an API token, see [Get an API Access Token](/docs/products/tools/api/guides/manage-api-tokens/) to create one.
+
+- **Limited sudo user** *(required)*: A limited user account with sudo access is created as part of this cluster deployment. Enter your preferred username for this limited user. Please note that the sudo password is automatically created and stored in the `~/.deployment_secrets.txt` file. See [Accessing the Nomad Web UI](#accessing-the-nomad-web-ui) below.
+
+- **Email Address** *(required)*: A valid SOA email address for auto-generated LetsEncrypt SSL.
+
+- **Add SSH Keys to all nodes?** If you select *yes*, any SSH Keys that are added to the root user account (in the **SSH Keys** section), are also added to your limited user account on all deployed Compute Instances.
+
+- **Total Instance Count:** The Nomad Cluster will deploy 6 Compute Instances.
+
+  |  Servers |  Clients | Total Instances |
+  | :--: | :--: | :--: |
+  | 3  | 3  | 6 |
+
+- **Nomad Server Count**: The Nomad Cluster will deploy 3 Nomad servers.
+
+- **Nomad Client Count**: The Nomad Cluster will deploy 3 Nomad clients.
+
+  {{< note >}}
+  See [Hashicorp's Nomad Architecture documentation](https://developer.hashicorp.com/nomad/docs/concepts/architecture) for more about how clients and servers function within the Nomad Cluster.
+  {{< /note >}}
+
+## Getting Started after Deployment
+
+### Accessing the Nomad Web UI
+
+1.  Use [SSH]() to connect as the created sudo user of the initially deployed instance, labeled `occ-server-1`.
+
+1.  Once logged in as your sudo user, view the contents of the file `~/.deployment-secrets.txt`.
+
+    ```command
+    cat ~/.deployment-secrets.txt`
+    ```
+    In this file, there are multiple generated tokens, as well as your limited sudo user password. These tokens are used for authenticating to the Nomad Web UI, adding Nomad clients to the cluster, managing jobs, and managing the Consul service mesh. Save the contents of this file somewhere secure as you will need the tokens later.
+
+1.  Open your web browser and navigate to `http://[rDNS]`, where `[rDNS]` is the reverse DNS address of your Compute Instance labeled `server-1`. See our [How to Configure rDNS](/docs/products/compute/compute-instances/guides/configure-rdns/) guide for more information about viewing and editing rDNS.
+
+1.  The [Nomad Web UI](https://learn.hashicorp.com/collections/nomad/web-ui) should be displayed with a link to enter a token. Click the token link, and enter the `nomad_user_token` from the `~/.deployment-secrets.txt` file (see above) to authenticate to the UI.
+
+    ![Screenshot of Nomad UI Authentication Screen](NomadUIAuthentication.jpg)
+
+1. Once your token is authenticated, you can manage your cluster, jobs, integrations, and ACL tokens.
+
+    ![Screenshot of the Nomad Web UI](Nomad-webUI.jpg)
+
+    {{< note >}}
+    HashiCorp recommends using mutual TLS (mTLS) with a private CA to secure cluster communications and the web UI. Please see the following HashiCorp documentation for more details:
+
+    - [Enable TLS Encryption for Nomad](https://learn.hashicorp.com/tutorials/nomad/security-enable-tls)
+    - [Nomad Configuration: tls Block](https://www.nomadproject.io/docs/configuration/tls#http)
+    {{< /note >}}
+
+## Next Steps
+
+The HashiCorp Nomad Cluster provides default configurations to get you started. We recommend reviewing HashiCorp's [Configuration](https://www.nomadproject.io/docs/configuration) and [Job Spec](https://www.nomadproject.io/docs/job-specification) documentation to customize your Nomad Cluster for your specific workload.
+
+If you find that you need additional Clients for your Nomad Cluster, the [Nomad Clients Cluster](/docs/products/tools/marketplace/guides/hashicorp-nomad-clients-cluster/) deployment allows you to scale horizontally by deploying 3, 5, or 7 additional Compute Instances as Clients.
+
+{{< content "marketplace-update-note-shortguide">}}