Add documentation for Digital Ocean

This commit is contained in:
voodoorai2000
2019-03-27 21:18:42 +01:00
parent 10d1e886c9
commit 874728a086
4 changed files with 120 additions and 0 deletions

View File

@@ -17,6 +17,7 @@
* [Local installation](getting_started/local_installation.md)
* [Development Mail Server](getting_started/dev_mailserver.md)
* [Production and Staging servers](getting_started/servers.md)
* [Digital Ocean](getting_started/digital_ocean.md)
* [Heroku](getting_started/deploying-on-heroku.md)
* [Docker](getting_started/docker.md)
* [Basic configuration](getting_started/basic_configuration.md)

View File

@@ -0,0 +1,59 @@
# Installing CONSUL on a Digital Ocean VPS
These instructions will help you register and buy a server in Digital Ocean to install CONSUL.
First you need to [sign up](https://cloud.digitalocean.com/registrations/new) and provide your personal information.
Once you are logged in, you need to create a Droplet (thats the name that Digital Ocean uses for a Virtual Server). Click on the “Create” green button at the top of the page and select "Droplets":
![Digital Ocean Droplets](../../img/digital_ocean/droplets.png)
In the next page, you need to select Ubuntu (it should be pre-selected) and change the version **from 18.04 x64 to 16.04 x64**.
![Digital Ocean Choose an image](../../img/digital_ocean/image.png)
In the "Choose a size" section select the **$80/mo 16GB/6CPUs** option if this is going to be a production server. If you are just setting up a test system with a few users the cheapest $5/mo option can be enough.
![Digital Ocean Choose a size](../../img/digital_ocean/size.png)
Leave the rest of the options with their defaults until “Choose a datacenter”. Select the one that will be geographically closer to your users. If you are in the EU, select either Frankfurt or Amsterdam data centers.
![Digital Ocean Choose a region](../../img/digital_ocean/region.png)
In the "Add you SSH keys" section click "New SSH Key" button.
![Digital Ocean Add your SSH Keys](../../img/digital_ocean/ssh_keys.png)
In the pop up window that appears you need to copy and paste the public key that we [generated in the previous step](generating_ssh_key.md). To see the content of this key in the terminal window type:
```
cat ~/.ssh/id_rsa.pub
```
You should see a text like this:
```
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDy/BXU0OsK8KLLXpd7tVnqDU+d4ZS2RHQmH+hv0BFFdP6PmUbKdBDigRqG6W3QBexB2DpVcb/bmHlfhzDlIHJn/oki+SmUYLSWWTWuSeF/1N7kWf9Ebisk6hiBkh5+i0oIJYvAUsNm9wCayQ+i3U3NjuB25HbgtyjR3jDPIhmg1xv0KZ8yeVcU+WJth0pIvwq+t4vlZbwhm/t2ah8O7hWnbaGV/MZUcj0/wFuiad98yk2MLGciV6XIIq+MMIEWjrrt933wAgzEB8vgn9acrDloJNvqx25uNMpDbmoNXJ8+/P3UDkp465jmejVd/6bRaObXplu2zTv9wDO48ZpsaACP your_username@your_computer_name
```
Select and copy all the text and paste it in the pop-up window like this:
![Digital Ocean New SSH Key](../../img/digital_ocean/new_ssh.png)
Please note that there will be two little green checks. If they are not there, retry copying the text because you probably left something out. Give your key a meaningful name, like **CONSUL_key** and click "Add SSH Key" button.
By using an SSH key instead of a user/password combination to access your server, it will be much more secure, as only someone with the private SSH key can access the server.
Now in the "Choose a hostname" section change the default for something more meaningful, like **consulserver** for example.
![Digital Ocean hostname](../../img/digital_ocean/hostname.png)
At the bottom of the page youll see a summary of your options. Check that everything is OK and click the big green "Create" button.
![Digital Ocean create](../../img/digital_ocean/create.png)
It will take a few minutes, and at the end you will have a shiny new server. It will look like this in the Digital Ocean page:
![Digital Ocean server](../../img/digital_ocean/server.png)
Next to setup CONSUL in the server check the [installer's README](https://github.com/consul/installer)

View File

@@ -17,6 +17,7 @@
* [Instalación local](getting_started/local_installation.md)
* [Servidor local de correo](getting_started/dev_mailserver.md)
* [Servidores de prueba y producción](getting_started/servers.md)
* [Digital Ocean](getting_started/digital_ocean.md)
* [Heroku](getting_started/deploying-on-heroku.md)
* [Docker](getting_started/docker.md)
* [Configuración básica](getting_started/basic_configuration.md)

View File

@@ -0,0 +1,59 @@
# Instalando CONSUL en un VPS de Digital Ocean
Estas instrucciones le ayudaran a registrarse y comprar un servidor en Digital Ocean para instalar CONSUL.
Primero necesita [registrarse](https://cloud.digitalocean.com/registrations/new) y proporcionar su información personal.
Una vez que haya iniciado sesión, deberá crear un Droplet (ese es el nombre que Digital Ocean utiliza para un Servidor Virtual). Haga clic en el botón verde "Crear" en la parte superior de la página y seleccione "Droplets":
![Digital Ocean Droplets](../../img/digital_ocean/droplets.png)
En la página siguiente, debe seleccionar Ubuntu (debería estar preseleccionado) y cambiar la versión **de 18.04 x64 a 16.04 x64**.
![Digital Ocean Choose an image](../../img/digital_ocean/image.png)
En la sección "Elegir un tamaño" seleccione la opción **$80/mo 16GB/6CPUs** si va a ser un servidor de producción. Si está configurando un sistema de prueba con unos pocos usuarios, la opción más barata de $5/mes puede ser suficiente.
![Digital Ocean Choose a size](../../img/digital_ocean/size.png)
Deje el resto de las opciones con sus valores por defecto hasta "Elegir un centro de datos". Seleccione el que esté geográficamente más cerca de sus usuarios. Si se encuentra en la UE, seleccione los centros de datos de Frankfurt o Amsterdam.
![Digital Ocean Choose a region](../../img/digital_ocean/region.png)
En la sección "Añadir claves SSH" pulse el botón "Nueva clave SSH".
![Digital Ocean Add your SSH Keys](../../img/digital_ocean/ssh_keys.png)
En la ventana emergente que aparece es necesario copiar y pegar la clave pública que [generamos en el paso anterior](generating_ssh_key.md). Para ver el contenido de esta clave en la ventana del terminal, escriba:
```
cat ~/.ssh/id_rsa.pub
```
Debería ver un texto como este:
```
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDy/BXU0OsK8KLLXpd7tVnqDU+d4ZS2RHQmH+hv0BFFdP6PmUbKdBDigRqG6W3QBexB2DpVcb/bmHlfhzDlIHJn/oki+SmUYLSWWTWuSeF/1N7kWf9Ebisk6hiBkh5+i0oIJYvAUsNm9wCayQ+i3U3NjuB25HbgtyjR3jDPIhmg1xv0KZ8yeVcU+WJth0pIvwq+t4vlZbwhm/t2ah8O7hWnbaGV/MZUcj0/wFuiad98yk2MLGciV6XIIq+MMIEWjrrt933wAgzEB8vgn9acrDloJNvqx25uNMpDbmoNXJ8+/P3UDkp465jmejVd/6bRaObXplu2zTv9wDO48ZpsaACP your_username@your_computer_name
```
Seleccione y copie todo el texto y péguelo en la ventana emergente de la siguiente manera:
![Digital Ocean New SSH Key](../../img/digital_ocean/new_ssh.png)
Tenga en cuenta que habrá dos pequeños checks verdes. Si no están ahí, vuelva a intentar copiar el texto porque probablemente omitió algo. Dé a su clave un nombre significativo, como **CONSUL_key** y haga clic en el botón "Add SSH Key" (Añadir clave SSH).
Al utilizar una clave SSH en lugar de una combinación de usuario/contraseña para acceder a su servidor, será mucho más seguro, ya que sólo alguien con la clave privada SSH puede acceder al servidor.
Ahora en la sección "Choose a hostname" cambie el valor por defecto por algo más significativo, como **consulserver** por ejemplo.
![Digital Ocean hostname](../../img/digital_ocean/hostname.png)
En la parte inferior de la página verás un resumen de tus opciones. Compruebe que todo está bien y haga clic en el botón grande verde "Crear".
![Digital Ocean create](../../img/digital_ocean/create.png)
Tardará unos minutos, y al final tendrá un brillante nuevo servidor. Se verá así en la página de Digital Ocean:
![Digital Ocean server](../../img/digital_ocean/server.png)
Lo siguiente es configurar CONSUL en el servidor. Por favor [leer estas instrucciones](https://github.com/consul/installer)