Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Release Candidate] v1.342.0 #7073

Merged
merged 4 commits into from
Aug 5, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions ci/vale/dictionary.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1767,6 +1767,8 @@ oneof
ons
opcache
openapi
openbao
OpenBao
opencart
opendkim
openfire
Expand Down Expand Up @@ -2707,6 +2709,8 @@ vagrantfile
valheim
validator
valim
valkey
Valkey
variadic
varnishlog
varonis
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Tax Information
description: "Learn which taxes are collected by Linode and how to add a tax identification number to your account."
published: 2019-04-09
modified: 2024-05-23
modified: 2024-08-05
keywords: ["accounts", "vat", "linode manager", "linode cloud manager", "manager", "tax", "taxes", "tax information", "usd", "vat id", "eu", "european union", "value added tax", "gst", "goods and services tax", "gst id", "tax id"]
aliases: ['/platform/billing-and-support/european-union-vat-linode/','/platform/billing-and-support/european-union-vat-linode-classic-manager/','/platform/billing-and-support/tax-information/','/platform/billing-and-support/tax-information-classic-manager/','/guides/tax-information/']
tags: ["linode platform"]
Expand Down Expand Up @@ -32,7 +32,7 @@ The following table lists each country that requires us to collect taxes. Alongs
| Czech Republic | 21% | [EU VAT](https://europa.eu/youreurope/business/taxation/vat/vat-rules-rates/index_en.htm) | July 1, 2019 |
| Denmark | 25% | [EU VAT](https://europa.eu/youreurope/business/taxation/vat/vat-rules-rates/index_en.htm) | July 1, 2019 |
| Egypt | 14% | [VAT](https://www.eta.gov.eg/en/content/egyptian-tax-authority-eta-has-recently-published-value-added-tax-vat-guidelines-digital) | March 1, 2024 |
| Estonia | 20% | [EU VAT](https://europa.eu/youreurope/business/taxation/vat/vat-rules-rates/index_en.htm) | July 1, 2019 |
| Estonia | 22% | [VAT](https://www.emta.ee/en/business-client/taxes-and-payment/value-added-tax) | January 1, 2024 |
| Greece | 24% | [EU VAT](https://europa.eu/youreurope/business/taxation/vat/vat-rules-rates/index_en.htm) | July 1, 2019 |
| Finland | 24% | [EU VAT](https://europa.eu/youreurope/business/taxation/vat/vat-rules-rates/index_en.htm) | July 1, 2019 |
| France | 20% | [EU VAT](https://europa.eu/youreurope/business/taxation/vat/vat-rules-rates/index_en.htm) | July 1, 2019 |
Expand Down
4 changes: 4 additions & 0 deletions docs/products/tools/marketplace/guides/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ See the [Marketplace](/docs/marketplace/) listing page for a full list of all Ma
- [Ant Media Server Enterprise Edition](/docs/products/tools/marketplace/guides/antmediaenterpriseserver/)
- [Ant Media Server](/docs/products/tools/marketplace/guides/antmediaserver/)
- [Apache Airflow](/docs/products/tools/marketplace/guides/apache-airflow/)
- [Apache Cassandra Cluster](/docs/products/tools/marketplace/guides/apache-cassandra-cluster/)
- [Apache Kafka Cluster](/docs/products/tools/marketplace/guides/apache-kafka-cluster/)
- [Appwrite](/docs/products/tools/marketplace/guides/appwrite/)
- [AzuraCast](/docs/products/tools/marketplace/guides/azuracast/)
Expand Down Expand Up @@ -57,6 +58,7 @@ See the [Marketplace](/docs/marketplace/) listing page for a full list of all Ma
- [HashiCorp Nomad](/docs/products/tools/marketplace/guides/hashicorp-nomad/)
- [HashiCorp Vault](/docs/products/tools/marketplace/guides/hashicorp-vault/)
- [ILLA Builder](/docs/products/tools/marketplace/guides/illa-builder/)
- [InfluxDB](/docs/products/tools/marketplace/guides/influxdb/)
- [Jenkins](/docs/products/tools/marketplace/guides/jenkins/)
- [JetBackup](/docs/products/tools/marketplace/guides/jetbackup/)
- [Jitsi](/docs/products/tools/marketplace/guides/jitsi/)
Expand Down Expand Up @@ -84,6 +86,7 @@ See the [Marketplace](/docs/marketplace/) listing page for a full list of all Ma
- [Node.js](/docs/products/tools/marketplace/guides/nodejs/)
- [Odoo](/docs/products/tools/marketplace/guides/odoo/)
- [ONLYOFFICE](/docs/products/tools/marketplace/guides/onlyoffice/)
- [Openbao](/docs/products/tools/marketplace/guides/openbao/)
- [OpenLiteSpeed Django](/docs/products/tools/marketplace/guides/openlitespeed-django/)
- [OpenLiteSpeed Node.js](/docs/products/tools/marketplace/guides/openlitespeed-nodejs/)
- [OpenLiteSpeed Rails](/docs/products/tools/marketplace/guides/openlitespeed-rails/)
Expand Down Expand Up @@ -117,6 +120,7 @@ See the [Marketplace](/docs/marketplace/) listing page for a full list of all Ma
- [Superinsight](/docs/products/tools/marketplace/guides/superinsight/)
- [Uptime Kuma](/docs/products/tools/marketplace/guides/uptime-kuma/)
- [UTunnel VPN](/docs/products/tools/marketplace/guides/utunnel/)
- [Valkey](/docs/products/tools/marketplace/guides/valkey/)
- [VictoriaMetrics Single](/docs/products/tools/marketplace/guides/victoriametrics-single/)
- [VS Code](/docs/products/tools/marketplace/guides/vscode/)
- [WarpSpeed VPN](/docs/products/tools/marketplace/guides/warpspeed/)
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
---
title: "Deploy Apache Cassandra Cluster through the Linode Marketplace"
description: "Apache Cassandra is an open-source, distributed NoSQL database management system designed for handling large amounts of data across many commodity servers, providing high availability with no single point of failure. Cassandra offers robust support for clusters with asynchronous masterless replication allowing low-latency operations for all clients. "
published: 2024-08-05
keywords: ['nosql','database', 'marketplace', 'cassandra']
tags: ["ubuntu","marketplace", "database", "linode platform", "cloud manager", "ssl", "cloud storage", "high availability", "compute storage"]
external_resources:
- '[About Apache Cassandra](https://cassandra.apache.org/)'
- '[Apache Cassandra Documentation](https://cassandra.apache.org/doc/latest/cassandra/architecture/overview.html)'
---

## Cluster Deployment Architecture

Create a highly available Apache Cassandra cluster through the Linode Marketplace. Apache Cassandra is an open-source, distributed NoSQL database management system designed for handling large amounts of data across many commodity servers, providing high availability with no single point of failure. Cassandra offers robust support for clusters with asynchronous masterless replication, allowing low-latency operations for all clients.

## Deploying a Marketplace App

{{% content "deploy-marketplace-apps-shortguide" %}}

{{% content "marketplace-verify-standard-shortguide" %}}

{{< note >}}
**Estimated deployment time:** Your Apache Cassandra cluster should be fully installed within 10-15 minutes after the Compute Instance has finished provisioning.
{{< /note >}}

## Configuration Options

- **Supported distributions:** Ubuntu 22.04 LTS
- **Suggested minimum plan:** All plan types and sizes can be used. For best results, a minimum of 8GB Dedicated CPU or Shared Compute Instance is recommended.

### Apache Cassandra Options

- **[Linode API Token](/docs/products/tools/api/guides/manage-api-tokens/#create-an-api-token):** The provisioner node uses an authenticated API token to create the additional components to the cluster. This is required to fully create the Apache Cassandra cluster.

{{% content "marketplace-required-limited-user-fields-shortguide" %}}

{{% content "marketplace-special-character-limitations-shortguide" %}}

- **Cassandra Database User:** Enter your database super username for the Cassandra cluster.

- **Number of clients connecting to Cassandra:** The number of clients that will be connecting to the cluster. The application will create SSL certificates for your clients that need to connect to the cluster. The number of clients should be an integer equal or greater than 1.

- **Cassandra cluster size:** The size of the Cassandra cluster

- **Country or Region:** Enter the country or region for you or your organization.

- **State or Province:** Enter the state or province for you or your organization.

- **Locality:** Enter the town or other locality for you or your organization.

- **Organization:** Enter the name of your organization.

- **Email Address:** Enter the email address you wish to use for your certificate file.

## Getting Started After Deployment

This Marketplace App creates a 3-5 node cluster using Apache Cassandra. Authentication to the cluster is secured via a user-supplied username. The default `cassandra` database role is removed and superseded by the new user role provided by the client. In addition, cluster communication is secured via SSL/TLS with self-signed keystores.

Both certificates and keystores can be found on every node in the `/etc/cassandra/ssl` directory. Only the first Cassandra server will have client certificates. This playbook also creates *_n_* amount of client certificates so that applications can connect to the Cassandra cluster.

### Connecting to Cassandra

Connect to Cassandra using `cqlsh` using client or server certificates. You will need 4 components to connect to the cluster:

- Username and password created by the playbook. You can find the credentials in `/home/$SUDO_USER/.credentials`, where `$SUDO_USER` is your sudo user created during deployment.
- Client certificate
- Client key
- CA certificate

1. On the client node, create the `/home/$SUDO_USER/cassandra_ssl` directory, where `$SUDO_USER` is your sudo user created during deployment.

2. From the first Cassandra node, securely transfer the following files and directories: `/etc/cassandra/ssl/cert/client1.crt`, `/etc/cassandra/ssl/key/client1.key`, and `/etc/cassandra/ssl/ca/ca.crt` to the `/home/$SUDO_USER/cassandra_ssl` directory on the client node.

3. Create a Cassandra resource file to use our client certificate. Create the `/home/$SUDO_USER/.cassandra` directory. In the `.cassandra` directory, create a `cqlshrc` file with the following content:

```
[connection]
ssl = true
factory = cqlshlib.ssl.ssl_transport_factory
[ssl]
certfile = /home/$SUDO_USER/cassandra_ssl/ca.crt
userkey = /home/$SUDO_USER/cassandra_ssl/client1.key
usercert = /home/$SUDO_USER/cassandra_ssl/client1.crt
validate = true
```

4. Connect to one of the Cassandra servers using `cqlsh`:

```command
cqlsh 192.168.139.160 -u superuser --ssl
```

Replace `192.168.139.160` with the private IP address of one of the Cassandra nodes and `superuser` with the Cassandra database user you provided when deploying the cluster. Once you are connected, enter the password from `/home/$SUDO_USER/.credentials` at the prompt to authenticate to the cluster.

```output
Connected to Cassandra Cluster at 192.168.139.160:9042
[cqlsh 6.1.0 | Cassandra 4.1.5 | CQL spec 3.4.6 | Native protocol v5]
Use HELP for help.
superadmin@cqlsh>
```

You can distribute the remainder of client certificates to the rest of the nodes.

## Software Included

The Apache Cassandra Marketplace App installs the following software on your Linode:

| **Software** | **Description** |
|:--------------|:------------|
| [**Apache Cassandra**](https://cassandra.apache.org/) | Open Source NoSQL Database. |
| [**UFW**](https://help.ubuntu.com/community/UFW) | Uncomplicated Firewall |

{{% content "marketplace-update-note-shortguide" %}}
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
63 changes: 63 additions & 0 deletions docs/products/tools/marketplace/guides/influxdb/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
description: "Deploy InfluxDB on a Linode Compute Instance. InfluxDB is a high-performance time series database designed to handle massive volumes of data with ease."
keywords: ['time series database','monitoring','analytics','data']
tags: ["marketplace", "linode platform", "cloud manager"]
published: 2024-08-05
modified_by:
name: Linode
title: "Deploy InfluxDB through the Linode Marketplace"
external_resources:
- '[InfluxData](https://www.influxdata.com/)'
authors: ["Linode"]
---

[InfluxDB](https://www.influxdata.com/) is a high-performance time series database designed to handle massive volumes of data with ease. Its intuitive query language and powerful visualization capabilities make it the go-to choice for monitoring, analytics, and IoT applications.

## Deploying a Marketplace App

{{% content "deploy-marketplace-apps-shortguide" %}}

{{% content "marketplace-verify-standard-shortguide" %}}

{{< note >}}
**Estimated deployment time:** InfluxDB should be fully installed within 5-10 minutes after the Linode has finished provisioning.
{{< /note >}}

## Configuration Options

- **Supported distributions:** Ubuntu 22.04 LTS
- **Suggested plan:** All plan types and sizes can be used.

### InfluxDB Options

- **Email address** *(required)*: Enter the email address to use for generating the SSL certificates.
- **Admin Username** *(required)*: Username for InfluxDB admin.
- **Organization Name** *(required)*: Name of the InfluxDB organization.
- **Bucket Name** *(required)*: Name of initial InfluxDB bucket.

{{% 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 InfluxDB Server

1. Access InfluxDB's welcome page by launching your preferred web browser and navigating to either the custom domain designated during deployment or your Linode's rDNS domain, such as `192-0-2-17.ip.linodeusercontent.com`. If you need assistance in finding your Linode's IP addresses and rDNS information, refer to the [Managing IP Addresses](/docs/products/compute/compute-instances/guides/manage-ip-addresses/) guide for detailed instructions.

![Screenshot of InfluxDB login page](influxdb_login.jpg)

1. Enter the username `admin` and the generated password provided in the compute instance's `/home/$SUDO_USER/.credentials` file. This lets you access the dashboard and begin using InfluxDB.

![Screenshot of InfluxDB login page](influxdb_dashboard.jpg)

### 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.

- [InfluxData](https://www.influxdata.com/)
- [InfluxDB Documentation](https://docs.influxdata.com/influxdb/v2/)

{{% content "marketplace-update-note-shortguide" %}}
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
38 changes: 25 additions & 13 deletions docs/products/tools/marketplace/guides/jenkins/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Deploy Jenkins through the Linode Marketplace"
description: "This guide shows how to install Jenkins, an open source automation tool which system administrators can use to build, test, and deploy your infrastructure."
published: 2020-03-12
modified: 2022-03-08
modified: 2024-08-05
keywords: ['jenkins','marketplace','pipeline','continuous delivery']
tags: ["linode platform","automation","marketplace","cloud-manager"]
external_resources:
Expand All @@ -26,39 +26,51 @@ aliases: ['/platform/marketplace/how-to-deploy-jenkins-with-marketplace-apps/',

## Configuration Options

- **Supported distributions:** Debian 10
- **Recommended minimum plan:** All plan types and sizes can be used.
- **Supported distributions:** Ubuntu 22.04 LTS
- **Suggested minimum plan:** All plan types and sizes can be used.

### Jenkins Options

{{% content "marketplace-required-limited-user-shortguide" %}}
{{% content "marketplace-special-character-limitations-shortguide" %}}

{{% content "marketplace-custom-domain-fields-shortguide" %}}

- **Let's Encrypt SOA Email:** *(required)* Email address for free Let's Encrypt SSL certificate.
- **Jenkins Version:** *(required)* Version of Jenkins to deploy.

## Getting Started after Deployment

After deploying your Jenkins instance, you are ready to log in and continue the configuration process. Follow the steps in the next section to get started.
After deploying your Jenkins instance, log in and continue the configuration.

### Access Your Jenkins Instance

1. [Connect to your Linode via SSH](/docs/products/compute/compute-instances/guides/set-up-and-secure/#connect-to-the-instance).
1. [Connect to your Linode via SSH](/docs/products/compute/compute-instances/guides/set-up-and-secure/#connect-to-the-instance) using `root` or the `sudo user` created during deployment if you added Account SSH Keys.

1. Retrieve your Jenkins admin password by viewing the contents of the `/var/lib/jenkins/secrets/initialAdminPassword` file.
1. Retrieve your Jenkins admin password from the `/home/$SUDO_USER/.credentials` file.

```command
cat /var/lib/jenkins/secrets/initialAdminPassword
cat /home/$SUDO_USER/.credentials
```

You should see a similar output
You should see a similar output:

```output
0f6fed516bc4ceab24373fe5de513dc
Sudo Username: $SUDO_USER
Sudo Password: ifdQUa3mD2UJSJ2NA9ddSDVl5NCWfKl
Jenkins Admin password: BeVrZwVkn1mUO0Gl38lRabp
```

1. Open a browser and navigate to `http://192.0.2.0:8080/`. Replace `192.0.2.0` with your [Linode's IP address](/docs/products/compute/compute-instances/guides/manage-ip-addresses/). This will bring you the *Unlock Jenkins* page. Enter the password you retrieved in the previous step and click **continue**.
1. Open a web browser and navigate to `https://192-0-2-17.ip.linodeusercontent.com`. Replace `192-0-2-17.ip.linodeusercontent.com` with the reverse DNS for your Compute Instance. This will open the *Unlock Jenkins* page. Enter the password you retrieved in the previous step and click **Continue**.

![Log into Jenkins with your admin password](jenkins-admin-login.png)

1. You are now ready to continue to configure Jenkins by installing the community suggested plugins or manually selecting plugins to install. Select the option you prefer.
1. Install the community-suggested plugins or select the plugins to install manually.

![Install Jenkins Plugins](install-jenkins-plugins.png)

1. After you have installed the desired plugins, you will be prompted to create your first admin user. Since the login password retrieved in the beginning of this section is temporary, you should create your admin user now.
1. After you install the desired plugins, create your first admin user. The Jenkins admin password you used earlier is temporary.

![Create your first Jenkins admin user.](create-admin-user.png)

{{% content "marketplace-update-note-shortguide" %}}
{{% content "marketplace-update-note-shortguide" %}}
Loading
Loading