Skip to content

Commit

Permalink
Merge pull request #319 from yuvipanda/digital-ocean-cloud
Browse files Browse the repository at this point in the history
Move digital ocean 'resize' docs out of 'install' step
  • Loading branch information
betatim authored May 10, 2019
2 parents 052df0b + b1c9a9f commit 1bf50d6
Show file tree
Hide file tree
Showing 4 changed files with 53 additions and 40 deletions.
4 changes: 1 addition & 3 deletions docs/howto/admin/resize.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <digitalocean/resize>`.
* :ref:`Digital Ocean <howto/providers/digitalocean/resize>`.

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
==================

Expand Down
43 changes: 43 additions & 0 deletions docs/howto/providers/digitalocean.rst
Original file line number Diff line number Diff line change
@@ -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`.
8 changes: 8 additions & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
============
Expand Down
38 changes: 1 addition & 37 deletions docs/install/digitalocean.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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

0 comments on commit 1bf50d6

Please sign in to comment.