-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Feature/feb 2024 marketplace apps (#6835)
* adds jupyterlab + nats drafts. updates openvpn for ansible release * update distro vers for cyberpanel + cloudron * update splunk deployment doc * update to required-limited-user shortcodes * add revisions from review * Fixes links, extra spaces, command code block formatting, and adds missing publish date --------- Co-authored-by: Matthew Wildman <matt@wildman.online>
- Loading branch information
1 parent
1e93188
commit 1cd7313
Showing
7 changed files
with
190 additions
and
29 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
64 changes: 64 additions & 0 deletions
64
docs/products/tools/marketplace/guides/jupyterlab/index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,64 @@ | ||
| --- | ||
| title: "Deploy JupyterLab through the Linode Marketplace" | ||
| description: "Deploy JupyterLab on a Linode Compute Instance. Jupyter is a web-based interactive development environment for notebooks, code, and data." | ||
| published: 2024-02-20 | ||
| modified_by: | ||
| name: Linode | ||
| keywords: ['productivity','notebook','data science'] | ||
| tags: ["marketplace", "linode platform", "cloud manager"] | ||
| external_resources: | ||
| - '[Project Jupyter](https://jupyter.org/)' | ||
| authors: ["Linode"] | ||
| --- | ||
|
|
||
| [JupyterLab](https://jupyter.org/) stands as the cutting-edge web-based interactive development environment, catering to notebooks, code, and data. With a flexible interface, users can easily configure and arrange workflows in data science, scientific computing, computational journalism, and machine learning. | ||
|
|
||
| ## Deploying a Marketplace App | ||
|
|
||
| {{< content "deploy-marketplace-apps-shortguide">}} | ||
|
|
||
| {{< content "marketplace-verify-standard-shortguide">}} | ||
|
|
||
| {{< note >}} | ||
| **Estimated deployment time:** JupyterLab should be fully installed within 10-15 minutes after the Compute Instance has finished provisioning. | ||
| {{< /note >}} | ||
|
|
||
| ## Configuration Options | ||
|
|
||
| - **Supported distributions:** Ubuntu 22.04 LTS | ||
| - **Recommended plan:** All plan types and sizes can be used. | ||
|
|
||
| ### JupyterLab Options | ||
|
|
||
| - **Email address** *(required)*: Enter the email address to use for generating the SSL certificates. | ||
|
|
||
| {{< content "marketplace-required-limited-user-fields-shortguide">}} | ||
|
|
||
| {{< content "marketplace-custom-domain-fields-shortguide">}} | ||
|
|
||
| {{< content "marketplace-special-character-limitations-shortguide">}} | ||
|
|
||
| ### Getting Started after Deployment | ||
|
|
||
| ## Accessing the Jupyter Server | ||
|
|
||
| Launch your web browser and navigate to the custom domain you set during deployment or the reverse DNS (rDNS) domain associated with your Compute Instance (e.g., 192-0-2-1.ip.linodeusercontent.com). This will direct you to the Jupyter Server login page, where you'll need to enter a token or password. For guidance on locating your Linode's IP addresses and rDNS information, consult the [Managing IP Addresses](/docs/products/compute/compute-instances/guides/manage-ip-addresses/) guide. | ||
|
|
||
| ## Obtaining the Jupyter Token | ||
|
|
||
| By default, Jupyter issues a token for authentication. The Jupyter access token was automatically generated during the initial install process and is stored in the `/root/.credentials` file. To view the default token, log in to your Compute Instance either through the [LISH Console](/docs/products/compute/compute-instances/guides/lish/#through-the-cloud-manager-weblish) or via SSH, and check the contents of the file: | ||
|
|
||
| ```command | ||
| cat /root/.credentials | ||
| ``` | ||
|
|
||
| Copy and paste this token into the **Password or token:** field on the Jupyter login page. If you prefer password authentication, use the token to set a password in the **Setup a Password** section on the login page. Once this is done, you can employ both the token and the password for accessing JupyterLab. | ||
|
|
||
| ### More Information | ||
|
|
||
| You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials. | ||
|
|
||
| - [Project Jupyter](https://jupyter.org/) | ||
| - [JupyterLab Documentation](https://jupyterlab.readthedocs.io/en/latest/) | ||
|
|
||
| {{< content "marketplace-update-note-shortguide">}} |
77 changes: 77 additions & 0 deletions
77
docs/products/tools/marketplace/guides/nats-single-node/index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,77 @@ | ||
| --- | ||
| title: "Deploy NATS through the Linode Marketplace" | ||
| description: "Deploy NATS on a Linode Compute Instance. NATS is a connective technology responsible for addressing, discovery and exchanging of messages that drive the common patterns in distributed systems; asking and answering questions, aka services/microservices, and making and processing statements, or stream processing." | ||
| published: 2024-02-20 | ||
| modified_by: | ||
| name: Linode | ||
| keywords: ['cloud native','microservices','distributed systems', 'PubSub'] | ||
| tags: ["marketplace", "linode platform", "cloud manager"] | ||
| external_resources: | ||
| - '[NATS](https://nats.io/)' | ||
| authors: ["Linode"] | ||
| --- | ||
|
|
||
| [NATS](https://docs.nats.io/nats-concepts/overview) is a connective technology built for the hyper-connected world. It is a single technology that enables applications to securely communicate across any combination of cloud vendors, on-premise, edge, web and mobile, and devices. NATS consists of a family of open-source products that are tightly integrated but can be deployed easily and independently. NATS is being used globally by thousands of companies, spanning use-cases including microservices, edge computing, mobile, and IoT. | ||
|
|
||
| ## Deploying a Marketplace App | ||
|
|
||
| {{< content "deploy-marketplace-apps-shortguide">}} | ||
|
|
||
| {{< content "marketplace-verify-standard-shortguide">}} | ||
|
|
||
| {{< note >}} | ||
| **Estimated deployment time:** NATS should be fully installed within 2-5 minutes after the Compute Instance has finished provisioning. | ||
| {{< /note >}} | ||
|
|
||
| ## Configuration Options | ||
|
|
||
| - **Supported distributions:** Ubuntu 22.04 LTS | ||
| - **Recommended plan:** All plan types and sizes can be used. | ||
|
|
||
| ### NATS Server Options | ||
|
|
||
| - **NATS Server Name**: The name for the NATS server. Default is "Test". | ||
| - **Version**: NATS server software version. Default is 2.10.1. | ||
| - **Email address** *(required)*: Enter the email address to use for generating the SSL certificates. | ||
| - **NATS Server Port**: NATS server port for clients to connect. Default is 4222. | ||
| - **NATS Websocket Port**: To setup the NATS server Websocket port. Default is 8888. | ||
| - **NATS MQTT Port**: To setup the NATS server MQTT port. Default is 1883. | ||
|
|
||
| {{< content "marketplace-required-limited-user-fields-shortguide">}} | ||
|
|
||
| {{< content "marketplace-custom-domain-fields-shortguide">}} | ||
|
|
||
| {{< content "marketplace-special-character-limitations-shortguide">}} | ||
|
|
||
| ### Getting Started after Deployment | ||
|
|
||
| ## Accessing the NATS Monitoring UI | ||
|
|
||
| To monitor the NATS messaging system, nats-server provides a lightweight HTTP server on a dedicated monitoring port. The monitoring server provides several endpoints, providing statistics and other information. | ||
|
|
||
| Open your web browser and go to the custom domain you specified during deployment or the rDNS domain of your Compute Instance (e.g., `192-0-2-1.ip.linodeusercontent.com`). This will take you to the NATS monitoring page. Refer to the [Monitoring NATS](https://docs.nats.io/running-a-nats-service/nats_admin/monitoring) guide for details on the different endpoints, statistics and other info you have access to. | ||
|
|
||
| ## Obtaining the NATS users passwords. | ||
|
|
||
| By default, this NATS deployment creates 2 users, one named "example" and another system user named "system". The passwords for these users are generated during the initial install process. To obtain these password, log in to your Compute Instance either through the [LISH Console](/docs/products/compute/compute-instances/guides/lish/#through-the-cloud-manager-weblish) or via SSH, then just read the /root/.credentials file, ie: | ||
|
|
||
| ```command | ||
| cat /root/.credentials | ||
| ``` | ||
| This file will contain the two credentials needed for those users. | ||
|
|
||
| For details, see [NATS Authorization](https://docs.nats.io/running-a-nats-service/configuration/securing_nats/authorization). | ||
|
|
||
| ### More Information | ||
|
|
||
| For more information, refer to these resources. Note that we can't confirm the authenticity of externally hosted materials. | ||
|
|
||
| - [Support](https://natsio.slack.com/) | ||
|
|
||
| - [Installation examples](https://docs.nats.io/running-a-nats-service/introduction/installation) | ||
|
|
||
| - [Sample code/Tutorials](https://natsbyexample.com/) | ||
|
|
||
| - [Latest version](https://github.com/nats-io/nats-server) | ||
|
|
||
| {{< content "marketplace-update-note-shortguide">}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters