Skip to content

Commit

Permalink
Merge pull request #6925 from wildmanonline/rc-v1.318.0
Browse files Browse the repository at this point in the history
[Release Candidate] v1.318.0
  • Loading branch information
wildmanonline committed Apr 29, 2024
2 parents 410dd24 + 7459a05 commit beb0e16
Show file tree
Hide file tree
Showing 45 changed files with 560 additions and 228 deletions.
16 changes: 8 additions & 8 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,18 +70,18 @@ To Install the latest Node.js LTS release on Windows, navigate to the [downloads

### Install Hugo

The Linode documentation library is built using [Hugo](http://gohugo.io), an open-source static site generator. In order to preview your guide before submission, you need to install Hugo on your local computer. This site currently uses **Hugo v0.116.1**. To remain consistent in the testing and development process, it's recommended to install this version instead of using a newer version.
The Linode documentation library is built using [Hugo](http://gohugo.io), an open-source static site generator. In order to preview your guide before submission, you need to install Hugo on your local computer. This site currently uses **Hugo v0.125.3**. To remain consistent in the testing and development process, it's recommended to install this version instead of using a newer version.

Note: If you observe any issues on a newer version, please [file an issue](https://github.com/linode/docs/issues) in the docs GitHub repository.

#### macOS and Linux

To install Hugo, download the appropriate binary for your system, extract it, and move it to a directory within your PATH.

1. Download the file below that corresponds with the OS and platform on your local system. If you don't see your system on this list, you can find additional files on the [Hugo v0.116.1 GitHub release page](https://github.com/gohugoio/hugo/releases/tag/v0.116.1) under **Assets**.
1. Download the file below that corresponds with the OS and platform on your local system. If you don't see your system on this list, you can find additional files on the [Hugo v0.125.3 GitHub release page](https://github.com/gohugoio/hugo/releases/tag/v0.125.3) under **Assets**.

- **macOS:** https://github.com/gohugoio/hugo/releases/download/v0.116.1/hugo_extended_0.116.1_darwin-universal.tar.gz
- **Linux:** https://github.com/gohugoio/hugo/releases/download/v0.116.1/hugo_extended_0.116.1_Linux-64bit.tar.gz
- **macOS:** https://github.com/gohugoio/hugo/releases/download/v0.125.3/hugo_extended_0.125.3_darwin-universal.tar.gz
- **Linux:** https://github.com/gohugoio/hugo/releases/download/v0.125.3/hugo_extended_0.125.3_Linux-64bit.tar.gz

You can download this file through a terminal using the curl command, replacing [url] with the URL for your platform:

Expand Down Expand Up @@ -115,7 +115,7 @@ To install Hugo, download the appropriate binary for your system, extract it, an

While macOS and Linux are preferred by most of the core Linode Docs team, it's also possible to use Hugo on Windows.

1. Download the [hugo_extended_0.116.1_windows-amd64.zip](https://github.com/gohugoio/hugo/releases/download/v0.116.1/hugo_extended_0.116.1_windows-amd64.zip) file. Additional files for other operating systems can be found on the [Hugo v0.116.1 GitHub release page](https://github.com/gohugoio/hugo/releases/tag/v0.116.1) under **Assets**.
1. Download the [hugo_extended_0.125.3_windows-amd64.zip](https://github.com/gohugoio/hugo/releases/download/v0.125.3/hugo_extended_0.125.3_windows-amd64.zip) file. Additional files for other operating systems can be found on the [Hugo v0.125.3 GitHub release page](https://github.com/gohugoio/hugo/releases/tag/v0.125.3) under **Assets**.

1. Extract the file to the directory you'd like to install Hugo under, such as `C:\Hugo\bin`.

Expand Down Expand Up @@ -184,10 +184,10 @@ For more information about using Git, refer to the [official Git documentation](

This section is only relevant to contributors who have previously worked on the docs repo prior to the Tailwind v3 upgrade (which occurred on July 6th, 2023 in docs release v1.252.0). After you merge in changes from this release (and onward), you will likely notice display issues when previewing the site locally. This is due to Tailwind v3 and the way it integrates with Hugo (and our theme). To complete the upgrade locally and fix any display issues, follow the steps below.

1. Upgrade Hugo to v0.116.1. On macOS, run the following commands in a temporary folder (not in your docs repo):
1. Upgrade Hugo to v0.125.3. On macOS, run the following commands in a temporary folder (not in your docs repo):

curl -OL https://github.com/gohugoio/hugo/releases/download/v0.116.1/hugo_extended_0.116.1_darwin-universal.tar.gz
tar -xvzf hugo_extended_0.116.1_darwin-universal.tar.gz
curl -OL https://github.com/gohugoio/hugo/releases/download/v0.125.3/hugo_extended_0.125.3_darwin-universal.tar.gz
tar -xvzf hugo_extended_0.125.3_darwin-universal.tar.gz
mv hugo /usr/local/bin

If you are using a different operating system, refer to the [Install Hugo](#install-hugo) section above.
Expand Down

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

15 changes: 0 additions & 15 deletions _vendor/github.com/linode/linode-website-partials/footer.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

14 changes: 4 additions & 10 deletions _vendor/github.com/linode/linode-website-partials/header.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions _vendor/modules.txt
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# github.com/linode/linode-docs-theme v0.0.0-20240423165854-a2056513af25
# github.com/linode/linode-website-partials v0.0.0-20240130163753-4a933fe77633
# github.com/linode/linode-docs-theme v0.0.0-20240429150342-36d65b1de62a
# github.com/linode/linode-website-partials v0.0.0-20240426140442-12b76ccbfefd
# github.com/gohugoio/hugo-mod-jslibs-dist/alpinejs/v3 v3.401.201
# github.com/gohugoio/hugo-mod-jslibs/turbo/v7 v7.20300.20000
# github.com/bep/turbo/v7 v7.20300.20000
Expand Down
2 changes: 1 addition & 1 deletion docs/products/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ layout = "tabbed-section-layout"
[cascade._target]
# The section rendering for individual product pages uses the tabbed layout
kind = "section"
path = "/products/*/*/**"
path = "/products/*/**"
+++

<!--more-->
Original file line number Diff line number Diff line change
Expand Up @@ -15,25 +15,22 @@ aliases: ['/quick-answers/linux/choosing-a-distribution/','/guides/choosing-a-di

## List of Distributions Available on Linode

Below is a full list of distributions, along with the release versions that we offer and a brief description. Release versions appearing in **bold** are the recommended version for that distribution. Once you've decided on a distribution, it's typically recommended to select the latest *LTS* (Long Term Support) release on systems intended for production use. This ensures that the system receives security updates for as long as possible.
Below is a full list of distributions. Once you've decided on a distribution, it's typically recommended to select the latest *LTS* (Long Term Support) release on systems intended for production use. This ensures that the system receives security updates for as long as possible. For release and version information, see [Supported Distributions](https://www.linode.com/distributions/).

| Distribution | Releases | Description |
|------|-------|-------|
| [AlmaLinux](https://almalinux.org/) | **9**, 8 | A nearly binary compatible derivative of RHEL intended to provide a long-term stable replacement for CentOS. Made by the same team as [CloudLinux OS](https://www.cloudlinux.com/) |
| [Alpine](https://alpinelinux.org/) | **3.19**, 3.18, 3.17, 3.16, 3.15\*\* | **Recommended for advanced Linux users only.** Lightweight distribution popular with [Docker](https://www.docker.com/) and security minded users. |
| [Arch](https://www.archlinux.org/) | Rolling release\* | **Recommended for advanced Linux users only.** Powerful and detail oriented, empowers more advanced users to fine tune their configuration. |
| [CentOS](https://www.centos.org) | **Stream 9**, Stream 8, 7 | Widely popular in professional and business settings while still being accessible to the average user. Versions 8 and earlier are binary equivalents of their corresponding RHEL (Red Hat Enterprise Linux) release. [CentOS Stream](https://www.redhat.com/en/topics/linux/what-is-centos-stream) has replaced CentOS and receives updates *just* ahead of the corresponding RHEL version. |
| [Debian](https://www.debian.org/) | **12**, 11, 10 | A popular and stable distribution that's been actively maintained longer than most other distributions. |
| [Fedora](https://getfedora.org/) | **39**, 38, 37 | Implements bleeding edge software. Fedora is similar though more advanced than CentOS and great for users who want to use the newest of the new and don't mind an added layer of complexity. |
| [Gentoo](https://www.gentoo.org/) | Rolling release\* | **Recommended for advanced Linux users only.** Advanced distribution designed for power users who want more control over their configuration and are comfortable compiling everything from source. |
| [Kali Linux](https://www.kali.org/) | Rolling release\* | **Recommended for advanced Linux users only.** A specialized and advanced Debian-based distribution designed for penetration testing and security auditing. This is a [minimum installation](https://www.kali.org/docs/troubleshooting/common-minimum-setup/), allowing you to install only the tools and metapackages you require. |
| [openSUSE Leap](https://www.opensuse.org/) | **15.5**, 15.4 | Provides powerful tools specific to system administration tasks. Starting with version 15.3, this distribution maintains parity with SLE (SUSE Linux Enterprise), making it a great choice for users of SLE or those looking to benefit from enterprise-grade stability. |
| [Rocky Linux](https://rockylinux.org/) | **9**, 8 | A nearly binary compatible derivative of RHEL intended to provide a long-term stable replacement for CentOS. Built by a community team led by the founder of the CentOS project. |
| [Slackware](http://www.slackware.com/) | **15**, 14.1 | **Recommended for advanced Linux users only.** The oldest actively maintained distribution. One of the most UNIX-like Linux distributions available. |
| [Ubuntu](https://ubuntu.com/) | 23.10, 23.04, 22.10\*\*, **22.04 LTS**, 20.04 LTS | Arguably the most popular Linux distribution, widely regarded for it's ease of use. The LTS versions of Ubuntu are featured heavily in Linode's guides and across the community. |

\* *Rolling release: Continuously updated release, typically with small but frequent updates.*<br>
** *Deprecated image: This image is still available for deployment but is no longer maintained by Linode.*
| Distribution | Description |
|------|-------|
| [AlmaLinux](https://almalinux.org/) | A nearly binary compatible derivative of RHEL intended to provide a long-term stable replacement for CentOS. Made by the same team as [CloudLinux OS](https://www.cloudlinux.com/) |
| [Alpine](https://alpinelinux.org/) | **Recommended for advanced Linux users only.** Lightweight distribution popular with [Docker](https://www.docker.com/) and security minded users. |
| [Arch](https://www.archlinux.org/) | **Recommended for advanced Linux users only.** Powerful and detail oriented, empowers more advanced users to fine tune their configuration. |
| [CentOS](https://www.centos.org) | Widely popular in professional and business settings while still being accessible to the average user. Versions 8 and earlier are binary equivalents of their corresponding RHEL (Red Hat Enterprise Linux) release. [CentOS Stream](https://www.redhat.com/en/topics/linux/what-is-centos-stream) has replaced CentOS and receives updates *just* ahead of the corresponding RHEL version. |
| [Debian](https://www.debian.org/) | A popular and stable distribution that's been actively maintained longer than most other distributions. |
| [Fedora](https://getfedora.org/) | Implements bleeding edge software. Fedora is similar though more advanced than CentOS and great for users who want to use the newest of the new and don't mind an added layer of complexity. |
| [Gentoo](https://www.gentoo.org/) | **Recommended for advanced Linux users only.** Advanced distribution designed for power users who want more control over their configuration and are comfortable compiling everything from source. |
| [Kali Linux](https://www.kali.org/) | **Recommended for advanced Linux users only.** A specialized and advanced Debian-based distribution designed for penetration testing and security auditing. This is a [minimum installation](https://www.kali.org/docs/troubleshooting/common-minimum-setup/), allowing you to install only the tools and metapackages you require. |
| [openSUSE Leap](https://www.opensuse.org/) | Provides powerful tools specific to system administration tasks. Starting with version 15.3, this distribution maintains parity with SLE (SUSE Linux Enterprise), making it a great choice for users of SLE or those looking to benefit from enterprise-grade stability. |
| [Rocky Linux](https://rockylinux.org/) | A nearly binary compatible derivative of RHEL intended to provide a long-term stable replacement for CentOS. Built by a community team led by the founder of the CentOS project. |
| [Slackware](http://www.slackware.com/) | **Recommended for advanced Linux users only.** The oldest actively maintained distribution. One of the most UNIX-like Linux distributions available. |
| [Ubuntu](https://ubuntu.com/) | Arguably the most popular Linux distribution, widely regarded for it's ease of use. The LTS versions of Ubuntu are featured heavily in Linode's guides and across the community. |

{{< note >}}
Though this list covers most popular distributions, creating a Linode using a distribution that we do not provide is possible. Feel free to follow our [Custom Distribution Guide](/docs/products/compute/compute-instances/guides/install-a-custom-distribution/) for more information.
Expand Down

0 comments on commit beb0e16

Please sign in to comment.