How-to guides
=============

These guides provide instructions for performing different operations related to our products on AWS.

EC2 - Launching and using Ubuntu instances
------------------------------------------

While using Ubuntu on AWS, you'll need to perform tasks such as launching an instance, finding the right image to use, creating an AMI, installing custom drivers, doing upgrades and setting up automated updates.

* :doc:`Launch instance using CLI <instances/launch-ubuntu-ec2-instance>`
* :doc:`Find images <instances/find-ubuntu-images>`
* :doc:`Launch a desktop <instances/launch-ubuntu-desktop>`
* :doc:`Launch and attest an AMD SEV-SNP instance <instances/launch-and-attest-amd-sev-snp-instances>`
* :doc:`Build an Ubuntu Pro AMI using Packer <instances/build-pro-ami-using-packer>`
* :doc:`Create CloudFormation templates <instances/build-cloudformation-templates>`
* :doc:`Install NVIDIA drivers <instances/install-nvidia-drivers>`
* :doc:`Configure multiple NICs <instances/automatically-setup-multiple-nics>`
* :doc:`In-place upgrade to Ubuntu Pro <instances/upgrade-in-place-from-lts-to-pro>`
* :doc:`Upgrade from Focal to Jammy <instances/upgrade-from-focal-to-jammy>`
* :doc:`Configure automated updates <instances/automatically-update-ubuntu-instances>`
* :doc:`Deploy Charmed Kubernetes <instances/deploy-charmed-kubernetes-on-ubuntu-pro>`
* :doc:`Deploy Canonical Data Science Stack <instances/data-science-stack-on-ec2>`
* :doc:`Import a local Ubuntu VM into AWS <instances/import-local-vm-to-aws>`


EKS - Using Ubuntu Pro and GPUs on EKS
--------------------------------------

If you want to use Ubuntu and enable GPUs on Amazon's EKS service, you can refer to these instructions.

* :doc:`Deploy an Ubuntu EKS cluster <kubernetes/deploy-ubuntu-cluster-with-eks-ami>`
* :doc:`Deploy an Ubuntu Pro cluster <kubernetes/deploy-ubuntu-pro-cluster-with-eks-pro-ami>`
* :doc:`Deploy an Ubuntu Pro FIPS cluster <kubernetes/deploy-ubuntu-pro-fips-cluster>`
* :doc:`Deploy a Pro cluster (with / without FIPS) using tokens <kubernetes/deploy-ubuntu-pro-cluster>`
* :doc:`Enable GPUs on EKS worker nodes <kubernetes/enable-gpus-on-eks>`


Security features
-----------------

AWS provides multiple features for additional security, many of which are supported through our Ubuntu images. These guides walk you through the steps needed to use these security features.

* :doc:`Use Secure Boot and TPM <security/use-secureboot-and-vtpm>`


Contributing to the docs
------------------------

If you come across any problems with this documentation and you want to help with corrections, suggestions or new content, here's how you can do that:


* :doc:`contribute-to-these-docs`

.. toctree::
   :hidden:
   :maxdepth: 1
   
   instances/index    
   kubernetes/index
   security/index   
   contribute-to-these-docs