diff --git a/docs/howto/admin/resize.rst b/docs/howto/admin/resize.rst index d0e9548..8cf1043 100644 --- a/docs/howto/admin/resize.rst +++ b/docs/howto/admin/resize.rst @@ -13,13 +13,11 @@ the cloud provider of your choice. Currently there are instructions to resize your resources on the following providers: -* :ref:`Digital Ocean `. +* :ref:`Digital Ocean `. Once resources have been reallocated, you must tell TLJH to make use of these resources, and verify that the resources have become available. -.. _tljhconf: - Verifying a Resize ================== diff --git a/docs/howto/providers/digitalocean.rst b/docs/howto/providers/digitalocean.rst new file mode 100644 index 0000000..081ad91 --- /dev/null +++ b/docs/howto/providers/digitalocean.rst @@ -0,0 +1,43 @@ +.. _howto/providers/digitalocean: + +================================================ +Perform common Digital Ocean configuration tasks +================================================ + +This page lists various common tasks you can perform on your +Digital Ocean virtual machine. + +.. _howto/providers/digitalocean/resize: + +Resizing your droplet +===================== + +As you use your JupyterHub, you may find that you need more memory, +disk space, or CPUs. Digital Ocean servers can be resized in the +"Resize Droplet" panel. These instructions take you through the process. + +#. First, click on the name of your newly-created + Droplet to enter its configuration page. + +#. Next, **turn off your Droplet**. This allows DigitalOcean to make + modifications to your VM. This will shut down your JupyterHub (temporarily). + + .. image:: ../../images/providers/digitalocean/power-off.png + :alt: Power off your Droplet + :width: 200px + +#. Once your Droplet has been turned off, click "Resize", + which will take you to a menu with options to resize your VM. + + .. image:: ../../images/providers/digitalocean/resize-droplet.png + :alt: Resize panel of digital ocean + +#. Decide what kinds of resources you'd like to resize, then click on a new VM + type in the list below. Finally, click "Resize". This may take a few moments! + +#. Once your Droplet is resized, **turn your Droplet back on**. This makes your JupyterHub + available to the world once again. This will take a few moments to complete. + +Now that you've resized your Droplet, you may want to change the resources available +to your users. Further information on making more resources available to +users and verifying resource availability can be found in :ref:`howto/admin/resize`. \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst index 1b7393c..7fa0ed0 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -95,6 +95,14 @@ Administration and security howto/admin/https howto/admin/enable-extensions +Cloud provider configuration +---------------------------- + +.. toctree:: + :titlesonly: + :caption: Cloud provider configuration + + howto/providers/digitalocean Topic Guides ============ diff --git a/docs/install/digitalocean.rst b/docs/install/digitalocean.rst index a4e316e..6d07e35 100644 --- a/docs/install/digitalocean.rst +++ b/docs/install/digitalocean.rst @@ -116,40 +116,4 @@ Step 2: Adding more users Step 3: Install conda / pip packages for all users ================================================== -.. include:: add_packages.txt - -.. _digitalocean/resize: - -Step 4: Resizing and editing the droplet -======================================== - -As you use your JupyterHub, you may find that you need more memory, -disk space, or CPUs. Digital Ocean servers can be resized in the -"Resize Droplet" panel. These instructions take you through the process. - -#. First, click on the name of your newly-created - Droplet to enter its configuration page. - -#. Next, **turn off your Droplet**. This allows DigitalOcean to make - modifications to your VM. This will shut down your JupyterHub (temporarily). - - .. image:: ../images/providers/digitalocean/power-off.png - :alt: Power off your Droplet - :width: 200px - -#. Once your Droplet has been turned off, click "Resize", - which will take you to a menu with options to resize your VM. - - .. image:: ../images/providers/digitalocean/resize-droplet.png - :alt: Resize panel of digital ocean - -#. Decide what kinds of resources you'd like to resize, then click on a new VM - type in the list below. Finally, click "Resize". This may take a few moments! - -#. Once your Droplet is resized, **turn your Droplet back on**. This makes your JupyterHub - available to the world once again. This will take a few moments to complete. - -Now that you've resized your Droplet, you may want to change the resources available -to your users. Further information on making more resources available to -users and verifying resource availability can be found in :ref:`howto/admin/resize`. - +.. include:: add_packages.txt \ No newline at end of file