diff --git a/docs/en/SUMMARY.md b/docs/en/SUMMARY.md index 6ed9fe633..9c474fd04 100644 --- a/docs/en/SUMMARY.md +++ b/docs/en/SUMMARY.md @@ -18,7 +18,6 @@ * [Development Mail Server](getting_started/dev_mailserver.md) * [Production and Staging servers](getting_started/servers.md) * [Heroku](getting_started/deploying-on-heroku.md) -* [Digital Ocean VPS](getting_started/digital_ocean_vps.md) * [Docker](getting_started/docker.md) * [Basic configuration](getting_started/basic_configuration.md) * [CONSUL Documentation and guides](getting_started/documentation_and_guides.md) diff --git a/docs/en/getting_started/digital_ocean_vps.md b/docs/en/getting_started/digital_ocean_vps.md deleted file mode 100644 index 03b1a26fa..000000000 --- a/docs/en/getting_started/digital_ocean_vps.md +++ /dev/null @@ -1,217 +0,0 @@ -# Installing CONSUL on a Digital Ocean VPS - -1. Installing ANSIBLE in the local machine - -In order to control the installation of CONSUL in the server, you need to install ANSIBLE in your local machine. The method depends on the kind of operative system that you are using. - -**Mac OSX** - -Open a Terminal console and type the following commands: - - ``` - sudo easy_install pip - sudo pip install ansible - ``` - -**Linux** - -You should install ANSIBLE using your package manager. For example, if you are using Ubuntu, these are the commands to install it: - - ``` - sudo apt-get update
 - sudo apt-get install software-properties-common
 - sudo apt-add-repository --yes --update ppa:ansible/ansible - sudo apt-get install ansible - ``` - -**Windows** - -In order to use ANSIBLE, you need to first install Cygwin, which is a UNIX environment for Windows. You can [download the software here](http://cygwin.com/setup-x86_64.exe). -Once downloaded, open a console window and type the following command (it’s all one long line): - - ``` - setup-x86_64.exe -q --packages=binutils,curl,cygwin32-gcc-g++,gcc-g++,git,gmp,libffi-devel,libgmp-devel,make,nano,openssh,openssl-devel,python-crypto,python-paramiko,python2,python2-devel,python2-openssl,python2-pip,python2-setuptools - ``` - -Once the installer finishes you will have a desktop shortcut that you can use to open a Cygwin terminal. In this terminal, type: - - ``` - pip2 install ansible - ``` - -2. Generating your SSH keys - -In the terminal window, type: - - ``` - ssh-keygen - ``` - -When prompted for the file in which to save the key just press ENTER to leave the default. When prompted for a passphrase, just press ENTER again to leave this empty. At the end you should see a message like this: - - ``` - Your identification has been saved in /your_home/.ssh/id_rsa.
 - Your public key has been saved in /your_home/.ssh/id_rsa.pub. - ``` - -Take note of the **id_rsa.pub** file location, because you’ll need the content of this file later. - -3. Buying the server from Digital Ocean - -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 (that’s 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 x 64 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. 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 bprieto@MacBook-Pro.local - ``` - -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 a SSH key instead of a user/password combination to access your server, it will be much more secure, as only someone with the 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 you’ll 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) - -4. Setting up the new server - -To enter your new server, copy the IP address of the server and in your terminal window type: - - ``` - ssh root@your-copied-ip-address - ``` - -You’ll see a welcome message and a prompt like this: - - ``` - root@consulserver:~# - ``` - -The first thing that you should do is to update the server, by typing these commands: - - ``` - apt update - apt upgrade -y - ``` - -If the upgrading process ask you something, just accept the default option. - -At the moment we are logged in with the root user, which is a bad practice that could compromise the server's security. So we need to create a new user to administer our server: - - ``` - adduser jupiter - ``` - -I'm using jupiter as the user name, you should change that for whatever makes sense to you. Input a password when prompted, and just leave empty the rest of the options. - -Let's give this user superadmin rights: - - ``` - usermod -aG sudo jupiter - ``` - -**Remember to change jupiter** for whatever username you chose in the previous step. - -Now we need to give the keys of the server to the new user. Don’t close the server terminal window, because you can lock yourself out of your server if there is a mistake. - -Open another local terminal window (not in the server) and type: - -``` -ssh-copy-id jupiter@your-copied-ip-address -``` - -Input your new user password when prompted. Remember to change "jupiter" for you username and "your-copied-ip-address" for the IP address of your server. - -Test that your user can log in by typing: - - ``` - ssh jupiter@your-copied-ip-address - ``` - -You should see the server welcome page and a prompt like this: - - ``` - jupiter@consulserver:~$ - ``` - -Note the username at the prompt is not "root", but your username. So everything is fine and we can now block the root account from outside access and also stop allowing password access so only people with SSH keys can log in. - -Type the following command to edit the SSH config file of the server: - - ``` - sudo nano /etc/ssh/sshd_config - ``` - -Look for the "PasswordAuthentication yes" line and change it to "PasswordAuthentication no". Type Control-K to close the nano editor and type: - - ``` - sudo service ssh restart - ``` - -We are getting there, we just need to install some required software for ANSIBLE by typing: - - ``` - sudo apt-get -y install python-simplejson - ``` - -5. Running the installer - -In your local machine terminal, type: - - ``` - git clone https://github.com/consul/installer
 - cd installer - cp hosts.example hosts - ``` - -Edit your hosts file to input your server IP address by typing "nano hosts" and changing "remote-server-ip-address" for your server IP address. Type Control-k to save and close the editor. - -Now we are ready at last to launch the installer. Type: - - ``` - sudo ansible-playbook -v consul.yml -i hosts - ``` - -You should see some messages from ANSIBLE as it’s working its way into the CONSUL installation. Pat yourself on the back, and go grab a coffee or something because this could take a while. - -When everything is finished, just go to your browser and type your IP address in the URL box. You should see your new **CONSUL** website up and running! 🎉 -There is a default admin user with **username admin@consul.dev and password 12345678**, so you can just login and start working with CONSUL. diff --git a/docs/es/SUMMARY.md b/docs/es/SUMMARY.md index 035cba905..bd8abfd4b 100644 --- a/docs/es/SUMMARY.md +++ b/docs/es/SUMMARY.md @@ -18,7 +18,6 @@ * [Servidor local de correo](getting_started/dev_mailserver.md) * [Servidores de prueba y producción](getting_started/servers.md) * [Heroku](getting_started/deploying-on-heroku.md) -* [Digital Ocean VPS](getting_started/digital_ocean_vps.md) * [Docker](getting_started/docker.md) * [Configuración básica](getting_started/basic_configuration.md) * [Documentación y guías sobre CONSUL](getting_started/documentation_and_guides.md) diff --git a/docs/es/getting_started/digital_ocean_vps.md b/docs/es/getting_started/digital_ocean_vps.md deleted file mode 100644 index 4741ec17d..000000000 --- a/docs/es/getting_started/digital_ocean_vps.md +++ /dev/null @@ -1,217 +0,0 @@ -# Instalando CONSUL en un VPS de Digital Ocean - -1. Instalar ANSIBLE en la máquina local - -Para poder controlar la instalación de CONSUL en el servidor, es necesario instalar ANSIBLE en su máquina local. El método depende del tipo de sistema operativo que esté utilizando. - -**Mac OSX** - -Abra una consola de terminal y escriba los siguientes comandos: - - ``` - sudo easy_install pip - sudo pip install ansible - ``` - -**Linux** - -Debe instalar ANSIBLE utilizando su gestor de paquetes. Por ejemplo, si está usando Ubuntu, estos son los comandos para instalarlo: - - ``` - sudo apt-get update
 - sudo apt-get install software-properties-common
 - sudo apt-add-repository --yes --update ppa:ansible/ansible -
 sudo apt-get install ansible - ``` - -**Windows** - -Para poder usar ANSIBLE, primero debe instalar Cygwin, que es un entorno UNIX para Windows. Puede[descargar el software aquí] (http://cygwin.com/setup-x86_64.exe). -Una vez descargado, abra una ventana de consola y escriba el siguiente comando (es todo una larga línea): - - ``` - setup-x86_64.exe -q --packages=binutils,curl,cygwin32-gcc-g++,gcc-g++,git,gmp,libffi-devel,libgmp-devel,make,nano,openssh,openssl-devel,python-crypto,python-paramiko,python2,python2-devel,python2-openssl,python2-pip,python2-setuptools - ``` - -Una vez que finalice el instalador, tendrá un acceso directo en el escritorio que puede utilizar para abrir un terminal Cygwin. En esta terminal, escriba: - - ``` - pip2 install ansible - ``` - -2. Generación de claves SSH - -En la ventana del terminal, escriba: - - ``` - ssh-keygen - ``` - -Cuando se le pida el archivo en el que guardar la clave, sólo tiene que pulsar ENTER para dejar el valor predeterminado. Cuando se le pida una frase de contraseña, pulse ENTER de nuevo para dejarla vacía. Al final debería ver un mensaje como este: - - ``` - Your identification has been saved in /your_home/.ssh/id_rsa.
 - Your public key has been saved in /your_home/.ssh/id_rsa.pub. - ``` - -Tome nota de la ubicación del archivo **id_rsa.pub**, porque necesitará el contenido de este archivo más adelante. - -3. Comprar el servidor de Digital Ocean - -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 x 64 a 16.04 x 64**. - -![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. 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 bprieto@MacBook-Pro.local - ``` - -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 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) - -4. Configuración del nuevo servidor - -Para entrar en su nuevo servidor, copie la dirección IP del servidor y en la ventana de su terminal escriba: - - ``` - ssh root@your-copied-ip-address - ``` - -Verá un mensaje de bienvenida y una indicación como ésta: - - ``` - root@consulserver:~# - ``` - -Lo primero que debe hacer es actualizar el servidor, escribiendo estos comandos: - - ``` - apt update - apt upgrade -y - ``` - -Si el proceso de actualización le pregunta algo, simplemente acepte la opción predeterminada. - -En este momento estamos conectados con el usuario root, lo cual es una mala práctica que podría comprometer la seguridad del servidor. Así que necesitamos crear un nuevo usuario para administrar nuestro servidor: - - ``` - adduser jupiter - ``` - -Estoy usando jupiter como nombre de usuario, debería cambiar eso por lo que sea que tenga sentido para usted. Introduzca una contraseña cuando se le pida y deje vacías el resto de las opciones. - -Démosle a este usuario derechos de superadministración: - - ``` - usermod -aG sudo jupiter - ``` - -**Recuerde cambiar jupiter** por cualquier nombre de usuario que haya elegido en el paso anterior. - -Ahora tenemos que dar las claves del servidor al nuevo usuario. No cierre la ventana de la terminal del servidor, porque puede bloquearse si hay un error. - -Abra otra ventana de terminal local (no en el servidor) y escriba: - -``` -ssh-copy-id jupiter@your-copied-ip-address -``` - -Introduzca su nueva contraseña de usuario cuando se le solicite. Recuerde cambiar "jupiter" para su nombre de usuario y "su dirección IP copiada" para la dirección IP de su servidor. - -Compruebe que su usuario puede iniciar sesión escribiendo: - - ``` - ssh jupiter@your-copied-ip-address - ``` - -Debería ver la página de bienvenida del servidor y un mensaje como este: - - ``` - jupiter@consulserver:~$ - ``` - -Note que el nombre de usuario en el prompt no es "root", sino su nombre de usuario. Así que todo está bien y ahora podemos bloquear la cuenta root del acceso externo y también dejar de permitir el acceso con contraseña para que sólo las personas con claves SSH puedan iniciar sesión. - -Escriba el siguiente comando para editar el archivo de configuración SSH del servidor: - - ``` - sudo nano /etc/ssh/sshd_config - ``` - -Busque la línea "PasswordAuthentication yes" y cámbiela por "PasswordAuthentication no". Escriba Control-K para cerrar el editor nano y escriba: - - ``` - sudo service ssh restart - ``` - -Ya casi estamos, sólo tenemos que instalar algún software necesario para ANSIBLE escribiendo: - - ``` - sudo apt-get -y install python-simplejson - ``` - -5. Ejecutar el instalador - -En el terminal de su máquina local, escriba: - - ``` - git clone https://github.com/consul/installer
 - cd installer - cp hosts.example hosts - ``` - -Edite el archivo de hosts para introducir la dirección IP de su servidor escribiendo "nano hosts" y cambiando "remote-server-ip-address" por la dirección IP de su servidor. Escriba Control-k para guardar y cerrar el editor. - -Ahora por fin estamos listos para iniciar el instalador. Escriba: - - ``` - sudo ansible-playbook -v consul.yml -i hosts - ``` - -Deberías ver algunos mensajes de ANSIBLE mientras se ejecuta la instalación de CONSUL. Mientras puede tomar un café..., esto puede tardar un rato. - -Cuando todo haya terminado, vaya a su navegador y escriba su dirección IP en la dirección URL. ¡Deberías ver tu nuevo sitio web **CONSUL** en funcionamiento! 🎉 -Hay un usuario de administración predeterminado con **nombre de usuario admin@consul.dev y contraseña 12345678**, por lo que sólo tiene que iniciar sesión y empezar a trabajar con CONSUL.