You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Updated some of the existing note shortcodes
* Update shortcodes in product docs
* Additional shortcode updates in guides
* Additional updates
* Additional changes
* Fix shortcodes that had an odd number of indent spaces
* Fix some merge conflict syntax that made it into production previously
Co-authored-by: Nathan Melehan <nmelehan@gmail.com>
Copy file name to clipboardExpand all lines: docs/guides/_shortguides/all-linodes-kvm-shortguide/index.md
+2-4
Original file line number
Diff line number
Diff line change
@@ -16,8 +16,6 @@ show_on_rss_feed: false
16
16
aliases: ['/all-linodes-kvm-shortguide/']
17
17
---
18
18
19
-
{{< note >}}
20
-
19
+
{{< note>}}
21
20
This guide mentions Xen architecture. However, all Linode instances now use KVM architecture. This guide may be updated or replaced in the future; or it may be retained for historical purposes.
Copy file name to clipboardExpand all lines: docs/guides/_shortguides/email-warning-shortguide/index.md
+2-4
Original file line number
Diff line number
Diff line change
@@ -16,8 +16,6 @@ show_on_rss_feed: false
16
16
aliases: ['/email-warning-shortguide/']
17
17
---
18
18
19
-
{{< disclosure-note "Note About Email at Linode" >}}
20
-
19
+
{{< note type="secondary" title="Note About Email at Linode" isCollapsible=true >}}
21
20
This guide may involve or result in sending email. In an effort to fight spam, Linode may restrict outbound connections on ports 25, 465, and 587 on Linodes for new accounts created after November 5th, 2019. For more information, please see [Sending Email on Linode](/docs/guides/running-a-mail-server/#sending-email-on-linode).
This guide is written for a non-root user. Commands that require elevated privileges are prefixed with `sudo`. If you're not familiar with the `sudo` command, visit our [Users and Groups](/docs/guides/linux-users-and-groups/) guide.
22
21
23
22
All configuration files should be edited with elevated privileges. Remember to include `sudo` before running your text editor.
Copy file name to clipboardExpand all lines: docs/guides/akamai/get-started/create-a-simple-microsite/index.md
+9-9
Original file line number
Diff line number
Diff line change
@@ -69,7 +69,7 @@ To avoid an unexpected bill make sure to delete this Linode Compute Instance onc
69
69
70
70
1. Enter required information under the **NodeJS Setup** section. For more information and instructions refer to [Guides - Deploying Node.js through the Linode Marketplace](/docs/products/tools/marketplace/guides/nodejs/).
71
71
72
-
{{< note >}}
72
+
{{< note respectIndent=false >}}
73
73
This guide involves configuring DNS settings and SSL certificates for your domain. These steps can be automated during the Marketplace App installation process by providing a Linode [API Token](/docs/products/tools/api/get-started/#create-an-api-token) during setup.
74
74
75
75
During installation, the API Token is used to generate a domain zone and records using Linode [DNS Manager](/docs/products/networking/dns-manager/). The Node.js Marketplace App then utilizes [certbot](https://certbot.eff.org/) to generate SSL certificates for your domain and subdomain.
@@ -93,7 +93,7 @@ If you plan to utilize Linode DNS Manager, we recommend taking steps now familia
93
93
94
94
1.[Verify Marketplace App installation](/docs/products/tools/marketplace/get-started/#verify-installation) before continuing with this guide. It may take several minutes for installation to complete.
95
95
96
-
{{< note >}}
96
+
{{< note respectIndent=false >}}
97
97
You can also create a Linode Compute instance using these options:
98
98
99
99
* Create a new Linux machine and install and set up a custom web server. For more information and instructions, refer to [Creating a Compute Instance](/docs/guides/creating-a-compute-instance/).
@@ -103,7 +103,7 @@ You can also create a Linode Compute instance using these options:
103
103
* To learn how to manually get an SSL certificate for your web server, refer to the [Enabling HTTPS Using Certbot with NGINX](/docs/guides/enabling-https-using-certbot-with-nginx-on-ubuntu) guide.
104
104
{{< /note >}}
105
105
106
-
{{< note >}}
106
+
{{< note respectIndent=false >}}
107
107
The steps in this example reference the Linode and Akamai user interfaces. You can also perform these tasks using [Terraform](/docs/guides/how-to-build-your-infrastructure-using-terraform-and-linode/), the management [API](/docs/products/tools/api/get-started/), or [CLI](/docs/products/tools/cli/get-started/).
|`www.test.com`| TXT |`_acme-challenge`|**Enter Record Value**|
177
177
178
-
{{< note >}}
178
+
{{< note respectIndent=false >}}
179
179
Ensure that there no extra empty spaces when entering the Record Value.
180
180
{{< /note >}}
181
181
@@ -193,7 +193,7 @@ Ensure that there no extra empty spaces when entering the Record Value.
193
193
194
194
1. After you complete the test, remove the line you added to your local hosts file and click **Next**.
195
195
196
-
{{< note >}}
196
+
{{< note respectIndent=false >}}
197
197
You can also test with staging IP addresses for your Edge hostname. For example, if your edge hostname is `www.test.com.edgesuite.net`, its staging hostname is `www.test.com.edgesuite-staging.net`.
198
198
199
199
Run the `nslookup` or `dig` commands on the staging hostname as shown below.
@@ -281,7 +281,7 @@ Before you start, make sure that each of your origin servers has a private IPv4
281
281
282
282
1. In the **SSL Certificate** section, paste the PEM-formatted contents of your web server SSL certificate.
283
283
284
-
{{< note >}}
284
+
{{< note respectIndent=false >}}
285
285
If using the Node.js Marketplace App, certificate files are located in the `/etc/letsencrypt/live/domain/` directory on your origin servers. Use the contents `fullchain.pem` and `privkey.pem` when configuring your NodeBalancer.
286
286
287
287
Otherwise, to learn how to get an SSL certificate, refer to the [Enabling HTTPS Using Certbot with NGINX](/docs/guides/enabling-https-using-certbot-with-nginx-on-ubuntu) guide.
@@ -293,7 +293,7 @@ Otherwise, to learn how to get an SSL certificate, refer to the [Enabling HTTPS
293
293
294
294

295
295
296
-
{{< note >}}
296
+
{{< note respectIndent=false >}}
297
297
To enable [Forward Secrecy](https://en.wikipedia.org/wiki/Forward_secrecy) for SSL/TLS connections, follow the instructions in the [NodeBalancer SSL Configuration](/docs/products/networking/nodebalancers/guides/ssl-termination/#diffie-hellman-parameters) guide.
298
298
299
299
If using the Node.js Marketplace app, Diffie-Hellman parameters are located on the Linode origin server in the `/etc/letsencrypt/ssl-dhparams.pem` file by default.
@@ -303,7 +303,7 @@ If using the Node.js Marketplace app, Diffie-Hellman parameters are located on t
303
303
304
304

305
305
306
-
{{< note >}}
306
+
{{< note respectIndent=false >}}
307
307
Make sure all the origin servers listen to HTTP, not HTTPS, otherwise the HTTP Status option will not work.
308
308
{{< /note >}}
309
309
@@ -331,7 +331,7 @@ Make sure all the origin servers listen to HTTP, not HTTPS, otherwise the HTTP S
For more information on configuration options, see the [TLS/SSL Termination on NodeBalancers](/docs/products/networking/nodebalancers/guides/ssl-termination/) guide.
Copy file name to clipboardExpand all lines: docs/guides/applications/big-data/apache-airflow-tutorial-creating-connections-and-variables/index.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -80,9 +80,9 @@ Using a JSON file to load [Airflow variables](https://airflow.apache.org/docs/st
80
80
dbname
81
81
{{</ output >}}
82
82
83
-
{{< note >}}
83
+
{{< note respectIndent=false >}}
84
84
Airflow saves the passwords for connections and any variable values in plain text within the metadata database. See the [A Recommended Workflow for Sensitive Variables](#a-recommended-workflow-for-sensitive-variables) section for ways to keep your variables secure.
Copy file name to clipboardExpand all lines: docs/guides/applications/big-data/big-data-in-the-linode-cloud-streaming-data-processing-with-apache-storm/index.md
+21-21
Original file line number
Diff line number
Diff line change
@@ -38,9 +38,9 @@ Some use cases where Storm is a good solution:
38
38
39
39
This guide explains how to create Storm clusters on the Linode cloud using a set of shell scripts that use Linode's Application Programming Interface (APIs) to programmatically create and configure large clusters. The scripts are all provided by the author of this guide via [GitHub repository](https://github.com/pathbreak/storm-linode). This application stack could also benefit from large amounts of disk space, so consider using our [Block Storage](/docs/products/storage/block-storage/) service with this setup.
40
40
41
-
{{< caution >}}
41
+
{{< note type="alert" >}}
42
42
External resources are outside of our control, and can be changed and/or modified without our knowledge. Always review code from third party sites yourself before executing.
You only need to run `source` on this file once in a single terminal session, unless you make changes to it.
141
141
{{< /note >}}
142
142
@@ -153,7 +153,7 @@ You only need to run `source` on this file once in a single terminal session, un
153
153
154
154
The default value of `124` selects Ubuntu 14.04 LTS 64-bit. If you'd like to use Debian 8 instead, change this value to `140`.
155
155
156
-
{{< note >}}
156
+
{{< note respectIndent=false >}}
157
157
The values represented in this guide are current as of publication, but are subject to change in the future. You can run `~/storm-linode/linode_api.py distributions` to see a list of all available distributions and their values in the API.
158
158
{{< /note >}}
159
159
@@ -163,7 +163,7 @@ The values represented in this guide are current as of publication, but are subj
163
163
- `DISABLE_SSH_PASSWORD_AUTHENTICATION`:
164
164
This disables SSH password authentication and allows only key-based SSH authentication for the Cluster Manager Linode. Password authentication is considered less secure, and is hence disabled by default. To enable password authentication, you can change this value to `no`.
165
165
166
-
{{< note >}}
166
+
{{< note respectIndent=false >}}
167
167
The options shown in this section are generated by the `linode_api.py` script, and differ slightly from the options shown using the Linode CLI tool. Do not use the Linode CLI tool to configure your Manager Node.
168
168
{{< /note >}}
169
169
@@ -202,9 +202,9 @@ Match User clustermgrguest
202
202
203
203
service ssh restart
204
204
205
-
{{< caution >}}
205
+
{{< note type="alert" respectIndent=false >}}
206
206
Since access to the cluster manager provides access to all Storm and Zookeeper clusters and any sensitive data they are processing, its security configuration should be considered critical, and access should be as restrictive as possible.
207
-
{{< /caution >}}
207
+
{{< /note >}}
208
208
209
209
9. Log in to the cluster manager Linode as the `root` user, using the public IP address shown when you created it:
210
210
@@ -298,7 +298,7 @@ When creating an image, you should have `clustermgr` authorization to the Cluste
298
298
299
299
All nodes of all clusters created from this image will have this distribution. The default value is `124` corresponding to Ubuntu 14.04 LTS 64-bit. For Debian 8 64-bit, change this value to `140`.
300
300
301
-
{{< note >}}
301
+
{{< note respectIndent=false >}}
302
302
The values represented in this guide are current as of publication, but are subject to change in the future. You can run `~/storm-linode/linode_api.py distributions` to see a list of all available distributions and their values in the API.
303
303
{{< /note >}}
304
304
@@ -430,7 +430,7 @@ The values represented in this guide are current as of publication, but are subj
430
430
431
431
If the process fails, ensure that you do not already have an existing Linode with the same name in the Linode Manager. If you do, delete it and run the command again, or recreate this image with a different name.
432
432
433
-
{{< note >}}
433
+
{{< note respectIndent=false >}}
434
434
During this process, a temporary, short-lived 2GB Linode is created and deleted. This will entail a small cost in your monthly invoice and trigger an event notification email to be sent to the address you have registered with Linode. This is expected behavior.
435
435
{{< /note >}}
436
436
@@ -539,9 +539,9 @@ When creating a cluster, you should have `clustermgr` authorization to the Clust
539
539
540
540
Set this value to `false` if the cluster manager node is located in the *same* Linode data center as the cluster nodes. This is the recommended value. Change to `true`**only** if the cluster manager node is located in a *different* Linode data center from the cluster nodes.
541
541
542
-
{{< caution >}}
542
+
{{< note type="alert" respectIndent=false >}}
543
543
It's important to set this correctly to avoid critical cluster creation failures.
544
-
{{< /caution >}}
544
+
{{< /note >}}
545
545
546
546
<br>
547
547
@@ -625,7 +625,7 @@ When creating an image, you should have `clustermgr` authorization to the Cluste
625
625
626
626
All nodes of all clusters created from this image will have this distribution. The default value is `124` corresponding to Ubuntu 14.04 LTS 64-bit. For Debian 8 64-bit, change this value to `140`.
627
627
628
-
{{< note >}}
628
+
{{< note respectIndent=false >}}
629
629
The values represented in this guide are current as of publication, but are subject to change in the future. You can run `~/storm-linode/linode_api.py distributions` to see a list of all available distributions and their values in the API.
630
630
{{< /note >}}
631
631
@@ -748,7 +748,7 @@ The values represented in this guide are current as of publication, but are subj
748
748
749
749
If the process fails, ensure that you do not already have an existing Storm image with the same name in the Linode Manager. If you do, delete it and run the command again, or recreate this image with a different name.
750
750
751
-
{{< note >}}
751
+
{{< note respectIndent=false >}}
752
752
During this process, a short-lived 2GB Linode is created and deleted. This will entail a small cost in the monthly invoice and trigger an event notification email to be sent to the address you have registered with Linode. This is expected behavior.
753
753
{{< /note >}}
754
754
@@ -869,9 +869,9 @@ When creating a cluster, you should have `clustermgr` authorization to the Clust
869
869
870
870
Set this value to `false` if the cluster manager node is located in the *same* Linode data center as the cluster nodes. This is the recommended value and is also the default. Change to `true`**only** if the cluster manager node is located in a *different* Linode data center from the cluster nodes.
871
871
872
-
{{< caution >}}
872
+
{{< note type="alert" respectIndent=false >}}
873
873
It's important to set this correctly to avoid critical cluster creation failures.
874
-
{{< /caution >}}
874
+
{{< /note >}}
875
875
876
876
<br>
877
877
@@ -921,7 +921,7 @@ It's important to set this correctly to avoid critical cluster creation failures
921
921
922
922
This section will explain how to start a Storm cluster. Doing so will also start any Zookeeper clusters on which it depends, so they do not need to be started separately.
923
923
924
-
{{< note >}}
924
+
{{< note respectIndent=false >}}
925
925
When starting a cluster, you should have `clustermgr` authorization to the Cluster Manager Linode.
926
926
{{< /note >}}
927
927
@@ -969,7 +969,7 @@ When performing the steps in this section, you should have `clustermgr` authoriz
969
969
970
970

971
971
972
-
{{< note >}}
972
+
{{< note respectIndent=false >}}
973
973
Any IP address that is being included in the file should be a *public facing IP* address of the network.
974
974
For example, company networks often assign local addresses like 10.x.x.x or 192.x.x.x addresses to employee workstations, which are then NATted to a public IP address while sending requests outside the company network.
975
975
Since the cluster client node is in the Linode cloud outside your company network, it will see monitoring requests as arriving from this public IP address. So it's the public IP address that should be allowed.
@@ -1198,9 +1198,9 @@ A user with only `clustermgrguest` authorization can use `cluster_info.sh` to de
1198
1198
1199
1199
Stopping a Zookeeper cluster cleanly stops the Zookeeper daemon on all nodes, and shuts down all nodes. The cluster can be restarted later. Note that the nodes **will** still incur Linode's hourly charges when stopped.
1200
1200
1201
-
{{< caution >}}
1201
+
{{< note type="alert" >}}
1202
1202
Do not stop a Zookeeper cluster while any Storm clusters that depend on it are running. This may result in data loss.
1203
-
{{< /caution >}}
1203
+
{{< /note >}}
1204
1204
1205
1205
To stop a cluster, use the `stop` command:
1206
1206
@@ -1210,9 +1210,9 @@ To stop a cluster, use the `stop` command:
1210
1210
1211
1211
Destroying a Zookeeper cluster permanently deletes all nodes of that cluster and their data. Unlike a Linode that is only shut down, destroyed or deleted Linodes no longer incur hourly charges.
1212
1212
1213
-
{{< caution >}}
1213
+
{{< note type="alert" >}}
1214
1214
Do not destroy a Zookeeper cluster while any Storm clusters that depend on it are running. It may result in data loss.
Without taking additional precautions, your Redis nodes may be exposed to the public internet via their respective public IP addresses. This means your nodes may be vulnerable to automated attacks. For more information, see [Redis Security](https://redis.io/topics/security).
102
102
103
103
To protect your Redis cluster from outside threats, consider utilizing [Cloud Firewalls](/docs/products/networking/cloud-firewall/) or [VLANs](/docs/products/networking/vlans/) to limit access to your cluster Linodes.
104
104
105
105
When using VLANs, replace `192.0.2.1` with the respective Linode's IPAM address in each configuration file.
106
-
{{< /caution >}}
106
+
{{< /note >}}
107
107
108
108
3. In `c_replica.conf`, the configuration is similar except for an update of the port number. `redis-cli` will be used later to configure this into a replica for the appropriate master.
Each node in the Redis cluster requires that the defined port the port plus 10000 are open. For example, **Server 1** must have TCP ports 6379 and 16379 open for the master node, and TCP ports 6381 and 16381 open for the replica node. Ensure iptables or ufw is configured properly for each server.
130
130
{{< /note >}}
131
131
@@ -167,7 +167,7 @@ At this point, each Linode hosts two independent master nodes. The Redis install
167
167
168
168
1. SSH into **Server 1**, then create a Redis cluster consisting of your three master nodes with the following command:
169
169
170
-
{{< note >}}
170
+
{{< note respectIndent=false >}}
171
171
If utilizing a [VLAN](/docs/products/networking/vlans/get-started/), use each Linode's IPAM address.
0 commit comments