diff --git a/source/tutorials/aws-web/figures/aws-web-1.png b/source/_figures/aws-web-1.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-1.png rename to source/_figures/aws-web-1.png diff --git a/source/tutorials/aws-web/figures/aws-web-10.png b/source/_figures/aws-web-10.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-10.png rename to source/_figures/aws-web-10.png diff --git a/source/tutorials/aws-web/figures/aws-web-11.png b/source/_figures/aws-web-11.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-11.png rename to source/_figures/aws-web-11.png diff --git a/source/tutorials/aws-web/figures/aws-web-12.png b/source/_figures/aws-web-12.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-12.png rename to source/_figures/aws-web-12.png diff --git a/source/tutorials/aws-web/figures/aws-web-13.png b/source/_figures/aws-web-13.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-13.png rename to source/_figures/aws-web-13.png diff --git a/source/tutorials/aws-web/figures/aws-web-14.png b/source/_figures/aws-web-14.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-14.png rename to source/_figures/aws-web-14.png diff --git a/source/tutorials/aws-web/figures/aws-web-2.png b/source/_figures/aws-web-2.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-2.png rename to source/_figures/aws-web-2.png diff --git a/source/tutorials/aws-web/figures/aws-web-3.png b/source/_figures/aws-web-3.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-3.png rename to source/_figures/aws-web-3.png diff --git a/source/tutorials/aws-web/figures/aws-web-4.png b/source/_figures/aws-web-4.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-4.png rename to source/_figures/aws-web-4.png diff --git a/source/tutorials/aws-web/figures/aws-web-5.png b/source/_figures/aws-web-5.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-5.png rename to source/_figures/aws-web-5.png diff --git a/source/tutorials/aws-web/figures/aws-web-6.png b/source/_figures/aws-web-6.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-6.png rename to source/_figures/aws-web-6.png diff --git a/source/tutorials/aws-web/figures/aws-web-7.png b/source/_figures/aws-web-7.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-7.png rename to source/_figures/aws-web-7.png diff --git a/source/tutorials/aws-web/figures/aws-web-8.png b/source/_figures/aws-web-8.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-8.png rename to source/_figures/aws-web-8.png diff --git a/source/tutorials/aws-web/figures/aws-web-9.png b/source/_figures/aws-web-9.png similarity index 100% rename from source/tutorials/aws-web/figures/aws-web-9.png rename to source/_figures/aws-web-9.png diff --git a/source/tutorials/azure/figures/azure-1.png b/source/_figures/azure-1.png similarity index 100% rename from source/tutorials/azure/figures/azure-1.png rename to source/_figures/azure-1.png diff --git a/source/tutorials/azure/figures/azure-2.png b/source/_figures/azure-2.png similarity index 100% rename from source/tutorials/azure/figures/azure-2.png rename to source/_figures/azure-2.png diff --git a/source/tutorials/azure/figures/azure-3.png b/source/_figures/azure-3.png similarity index 100% rename from source/tutorials/azure/figures/azure-3.png rename to source/_figures/azure-3.png diff --git a/source/tutorials/aws-web/aws-web.rst b/source/get-started/cloud-install/aws-web.rst similarity index 94% rename from source/tutorials/aws-web/aws-web.rst rename to source/get-started/cloud-install/aws-web.rst index b4de082e..19f5ad71 100644 --- a/source/tutorials/aws-web/aws-web.rst +++ b/source/get-started/cloud-install/aws-web.rst @@ -41,7 +41,7 @@ Locate, select, and launch the |CL| Basic AMI #. Start from your main AWS services console menu in your browser and select the :guilabel:`EC2` text as shown in Figure 1: - .. figure:: figures/aws-web-1.png + .. figure:: /_figures/aws-web-1.png :scale: 50 % :alt: AWS Console @@ -52,7 +52,7 @@ Locate, select, and launch the |CL| Basic AMI #. To create a new |CL| instance from the :guilabel:`EC2 Dashboard` menu, select the :guilabel:`Launch Instance` button as shown in Figure 2: - .. figure:: figures/aws-web-2.png + .. figure:: /_figures/aws-web-2.png :scale: 50 % :alt: EC2 Dashboard @@ -75,7 +75,7 @@ Locate, select, and launch the |CL| Basic AMI #. Select the :guilabel:`Clear Linux OS Basic` AMI by clicking the :guilabel:`Select` button as shown in Figure 3: - .. figure:: figures/aws-web-3.png + .. figure:: /_figures/aws-web-3.png :scale: 50 % :alt: Step 1: Choose AMI @@ -86,7 +86,7 @@ Locate, select, and launch the |CL| Basic AMI running |CL| on different platform configurations as shown in Figure 4. Select the :guilabel:`Continue` button. - .. figure:: figures/aws-web-4.png + .. figure:: /_figures/aws-web-4.png :scale: 50 % :alt: Clear Linux OS Basic @@ -94,7 +94,7 @@ Locate, select, and launch the |CL| Basic AMI #. The :guilabel:`Choose Instance Type` menu appears as shown in Figure 5. - .. figure:: figures/aws-web-5.png + .. figure:: /_figures/aws-web-5.png :scale: 50 % :alt: Choose an Instance Type @@ -116,7 +116,7 @@ Locate, select, and launch the |CL| Basic AMI the :guilabel:`Previous` screen to change the configuration or :guilabel:`Launch` the instance defined. - .. figure:: figures/aws-web-6.png + .. figure:: /_figures/aws-web-6.png :scale: 50 % :alt: Step 7: Review the Instance Launch @@ -126,7 +126,7 @@ Locate, select, and launch the |CL| Basic AMI Figure 7, asking you to :guilabel:`Select an existing key pair or create a new pair`. - .. figure:: figures/aws-web-7.png + .. figure:: /_figures/aws-web-7.png :scale: 50 % :alt: Select an existing key pair or create a new pair @@ -144,7 +144,7 @@ Locate, select, and launch the |CL| Basic AMI :guilabel:`Launch Instances` button to proceed to the :guilabel:`Launch Status` menu shown in Figure 8. - .. figure:: figures/aws-web-8.png + .. figure:: /_figures/aws-web-8.png :scale: 50 % :alt: Launch Status @@ -154,7 +154,7 @@ Locate, select, and launch the |CL| Basic AMI Figure 9, select the :guilabel:`View Instances` button to view your :guilabel:`Instances` dashboard. - .. figure:: figures/aws-web-9.png + .. figure:: /_figures/aws-web-9.png :scale: 50 % :alt: View Instance @@ -167,7 +167,7 @@ Your :guilabel:`Instances` Dashboard is shown in Figure 10 with the new |CL| OS basic instance already selected and in the running state. If there are other instances available, they are also listed but not selected. -.. figure:: figures/aws-web-10.png +.. figure:: /_figures/aws-web-10.png :scale: 50 % :alt: Instance Dashboard @@ -179,7 +179,7 @@ other instances available, they are also listed but not selected. .. _fig-aws-web-11: -.. figure:: figures/aws-web-11.png +.. figure:: /_figures/aws-web-11.png :scale: 50 % :alt: Connect to Your Instance @@ -235,7 +235,7 @@ Update the |CL| instance Run the :command:`sudo swupd update` command to update the operating system as shown in Figure 12: -.. figure:: figures/aws-web-12.png +.. figure:: /_figures/aws-web-12.png :scale: 50 % :alt: sudo swupd update @@ -259,7 +259,7 @@ instance from running. Figure 13 illustrates these steps. - .. figure:: figures/aws-web-13.png + .. figure:: /_figures/aws-web-13.png :scale: 50 % :alt: Stop Instance @@ -269,7 +269,7 @@ instance from running. your instance will be lost. Select the :guilabel:`Yes, Stop` button to stop your |CL| instance. -.. figure:: figures/aws-web-14.png +.. figure:: /_figures/aws-web-14.png :scale: 50 % :alt: Stop Instances diff --git a/source/tutorials/azure.rst b/source/get-started/cloud-install/azure.rst similarity index 99% rename from source/tutorials/azure.rst rename to source/get-started/cloud-install/azure.rst index 82f3f319..251a0828 100644 --- a/source/tutorials/azure.rst +++ b/source/get-started/cloud-install/azure.rst @@ -269,7 +269,7 @@ Log into your Microsoft Azure account #. Open your browser and enter the page `https://aka.ms/devicelogin` as shown in figure 1: - .. figure:: azure/figures/azure-1.png + .. figure:: /_figures/azure-1.png :scale: 50 % :alt: Microsoft Device Login @@ -280,7 +280,7 @@ Log into your Microsoft Azure account session login and will be different each time you log into MS Azure using the :command:`az login` command. - .. figure:: azure/figures/azure-2.png + .. figure:: /_figures/azure-2.png :scale: 50 % :alt: Microsoft Device Login - Azure CLI @@ -294,7 +294,7 @@ Log into your Microsoft Azure account have signed into the Microsoft Cross-platform Command Line Interface application on your device and you can close the window. - .. figure:: azure/figures/azure-3.png + .. figure:: /_figures/azure-3.png :scale: 50 % :alt: Microsoft Azure Cross-platform CLI diff --git a/source/get-started/index.rst b/source/get-started/index.rst index a0ff24fd..b15908dd 100644 --- a/source/get-started/index.rst +++ b/source/get-started/index.rst @@ -46,4 +46,13 @@ Install in a virtual machine :glob: virtual-machine-install/* - ../../guides/maintenance/increase-virtual-disk-size.rst \ No newline at end of file + ../../guides/maintenance/increase-virtual-disk-size.rst + +Install in the cloud +******************** + +.. toctree:: + :maxdepth: 1 + :glob: + + cloud-install/* \ No newline at end of file diff --git a/source/tutorials/docker/docker.rst b/source/tutorials/docker/docker.rst index 2c885f77..afdcd7d6 100644 --- a/source/tutorials/docker/docker.rst +++ b/source/tutorials/docker/docker.rst @@ -1,7 +1,7 @@ .. _docker: -Run Docker\* on |CL-ATTR| -######################### +Run Docker\* +############ |CL-ATTR| supports multiple containerization platforms, including a Docker solution. |CL| has many unique features including a minimal default diff --git a/source/tutorials/flatpak/flatpak.rst b/source/tutorials/flatpak/flatpak.rst index 1ca74e39..6bf09b14 100644 --- a/source/tutorials/flatpak/flatpak.rst +++ b/source/tutorials/flatpak/flatpak.rst @@ -1,7 +1,7 @@ .. _flatpak: -Use Flatpak\* to install applications on |CL-ATTR| -################################################## +Flatpak\* +######### This tutorial provides all the required steps to install Flatpak as well as downloading, installing, and running LibreOffice\* on |CL-ATTR|. diff --git a/source/tutorials/fmv.rst b/source/tutorials/fmv.rst index 2b31bde1..d1b7ae32 100644 --- a/source/tutorials/fmv.rst +++ b/source/tutorials/fmv.rst @@ -1,7 +1,7 @@ .. _fmv: -Use the function multi-version patch generator -############################################## +Function multi-version patch generator +###################################### CPU architectures often gain interesting new instructions as they evolve but application developers find it difficult to take advantage of those diff --git a/source/tutorials/hadoop.rst b/source/tutorials/hadoop.rst index 633c84d5..7f443891 100644 --- a/source/tutorials/hadoop.rst +++ b/source/tutorials/hadoop.rst @@ -1,10 +1,10 @@ .. _hadoop: -Set up a single node cluster with Hadoop\* -########################################## +Apache\* Hadoop\* +################# This tutorial walks you through the process of installing, configuring, and -running Apache\* Hadoop on |CL-ATTR|. The Apache Hadoop software library is a +running Apache Hadoop on |CL-ATTR|. The Apache Hadoop software library is a framework for distributed processing of large data sets across clusters of computers using simple programming models. It is designed to scale up from single servers to thousands of machines, with each machine offering local diff --git a/source/tutorials/index.rst b/source/tutorials/index.rst index 48f78344..c3708d8a 100644 --- a/source/tutorials/index.rst +++ b/source/tutorials/index.rst @@ -13,17 +13,15 @@ Explore our tutorials to discover what you can do with |CL|! flatpak/flatpak machine-learning/machine-learning docker/docker - azure hadoop fmv - aws-web/aws-web smb/smb* spark kata - kata_migration kubernetes/kubernetes* yubikey-u2f nvidia nvidia-cuda redis - tutorial-proxy + proxy + kata_migration \ No newline at end of file diff --git a/source/tutorials/kata.rst b/source/tutorials/kata.rst index 7f4863fc..23c8eb4a 100644 --- a/source/tutorials/kata.rst +++ b/source/tutorials/kata.rst @@ -1,7 +1,7 @@ .. _kata: -Install Kata Containers\* -######################### +Kata Containers\* +################# This tutorial describes how to install, configure, and run `Kata Containers`_ on |CL-ATTR|. diff --git a/source/tutorials/kubernetes/kubernetes-bp.rst b/source/tutorials/kubernetes/kubernetes-bp.rst index a7126e2b..757f4515 100644 --- a/source/tutorials/kubernetes/kubernetes-bp.rst +++ b/source/tutorials/kubernetes/kubernetes-bp.rst @@ -1,7 +1,7 @@ .. _kubernetes-bp: -Kubernetes Best Practices on |CL| -################################# +Kubernetes\* Best Practices +########################### Use swupd to update clusters **************************** diff --git a/source/tutorials/kubernetes/kubernetes.rst b/source/tutorials/kubernetes/kubernetes.rst index 93c8d68c..8fc7b841 100644 --- a/source/tutorials/kubernetes/kubernetes.rst +++ b/source/tutorials/kubernetes/kubernetes.rst @@ -1,7 +1,7 @@ .. _kubernetes: -Run Kubernetes\* -################ +Kubernetes\* +############ This tutorial describes how to install, configure, and run the `Kubernetes container orchestration system`_ on |CL-ATTR| using CRI+O and diff --git a/source/tutorials/machine-learning/machine-learning.rst b/source/tutorials/machine-learning/machine-learning.rst index de491bb7..7e640526 100644 --- a/source/tutorials/machine-learning/machine-learning.rst +++ b/source/tutorials/machine-learning/machine-learning.rst @@ -1,7 +1,7 @@ .. _machine-learning: -TensorFlow\* machine learning on |CL-ATTR| -########################################## +TensorFlow\* machine learning +############################# This tutorial demonstrates the installation and execution of a TensorFlow\* machine learning example on |CL-ATTR|. It uses a Jupyter\* Notebook and MNIST diff --git a/source/tutorials/nvidia-cuda.rst b/source/tutorials/nvidia-cuda.rst index c3735b53..aa056c1a 100644 --- a/source/tutorials/nvidia-cuda.rst +++ b/source/tutorials/nvidia-cuda.rst @@ -1,7 +1,7 @@ .. _nvidia-cuda: -Install NVIDIA CUDA Toolkit -########################### +NVIDIA\* CUDA Toolkit +##################### NVIDIA is a manufacturer of graphics processing units (GPU), also known as graphics cards. diff --git a/source/tutorials/nvidia.rst b/source/tutorials/nvidia.rst index 5473bed9..b1be1d8d 100644 --- a/source/tutorials/nvidia.rst +++ b/source/tutorials/nvidia.rst @@ -1,7 +1,7 @@ .. _nvidia: -Install NVIDIA\* Drivers -######################## +NVIDIA\* Drivers +################ NVIDIA manufactures graphics processing units (GPU), also known as graphics cards. diff --git a/source/tutorials/tutorial-proxy.rst b/source/tutorials/proxy.rst similarity index 98% rename from source/tutorials/tutorial-proxy.rst rename to source/tutorials/proxy.rst index b538dd66..f7d33270 100644 --- a/source/tutorials/tutorial-proxy.rst +++ b/source/tutorials/proxy.rst @@ -1,7 +1,7 @@ .. _tutorial-proxy: -Setting up proxy -################ +Proxy +##### This tutorial shows you how to configure your system for use behind an outbound proxy to access the Internet. diff --git a/source/tutorials/redis.rst b/source/tutorials/redis.rst index 1d86e4c9..3e4addb1 100644 --- a/source/tutorials/redis.rst +++ b/source/tutorials/redis.rst @@ -1,7 +1,7 @@ .. _redis: -Run Redis on |CL-ATTR| -###################### +Redis\* +####### Redis is an in-memory key:value store designed for quick lookups, accessible over the network. In this tutorial, you'll install redis and launch a diff --git a/source/tutorials/smb/smb-desktop.rst b/source/tutorials/smb/smb-desktop.rst index efa4c260..ac185217 100644 --- a/source/tutorials/smb/smb-desktop.rst +++ b/source/tutorials/smb/smb-desktop.rst @@ -1,7 +1,7 @@ .. _smb-desktop: -Connect to Windows\* shared location from |CL-ATTR| desktop -########################################################### +Samba\* as a client +################### This tutorial explains how to access an existing shared drive on Windows\* via Server Message Block (SMB) / Common Internet File System (CIFS) diff --git a/source/tutorials/smb/smb.rst b/source/tutorials/smb/smb.rst index a2892d22..4ffc7919 100644 --- a/source/tutorials/smb/smb.rst +++ b/source/tutorials/smb/smb.rst @@ -1,7 +1,7 @@ .. _clear-samba-share-to-Windows: -Enable simple file sharing with a Windows\* machine using Samba\* -################################################################# +Samba\* as a host +################# This tutorial describes how to enable simple file sharing from a system running |CL-ATTR| to a Windows machine using Samba. For more advanced sharing, diff --git a/source/tutorials/spark.rst b/source/tutorials/spark.rst index 2f0d22ab..0624fd5b 100644 --- a/source/tutorials/spark.rst +++ b/source/tutorials/spark.rst @@ -1,7 +1,7 @@ .. _spark: -Set up a standalone cluster system using Apache\* Spark\* -######################################################### +Apache\* Spark\* +################ This tutorial describes how to install, configure, and run Apache Spark on |CL-ATTR|. Apache Spark is a fast general-purpose cluster computing system with diff --git a/source/tutorials/wordpress/wordpress.rst b/source/tutorials/wordpress/wordpress.rst index 6eecac79..451cdaa4 100644 --- a/source/tutorials/wordpress/wordpress.rst +++ b/source/tutorials/wordpress/wordpress.rst @@ -1,7 +1,7 @@ .. _wordpress: -WordPress\* on |CL-ATTR| -######################## +WordPress\* +########### This tutorial describes how to setup a web server to host a WordPress\* site on a |CL-ATTR| system. The tutorial is split into two sections: diff --git a/source/tutorials/yubikey-u2f.rst b/source/tutorials/yubikey-u2f.rst index 59401efe..83ff4c60 100644 --- a/source/tutorials/yubikey-u2f.rst +++ b/source/tutorials/yubikey-u2f.rst @@ -1,7 +1,7 @@ .. _yubikey-u2f: -Enable YubiKey U2F Support -########################## +YubiKey\* U2F Support +##################### YubiKey\* is a USB security token manufactured by `Yubico`_. Depending on the model, a YubiKey can support different authentication protocols including: