Merge pull request #110 from consul/mailserver

Update mail server configuration section
This commit is contained in:
Javi Martín
2021-11-10 13:39:10 +01:00
committed by GitHub
5 changed files with 78 additions and 105 deletions

View File

@@ -23,7 +23,7 @@
* [Digital Ocean](en/installation/digital_ocean.md)
* [Heroku](en/installation/deploying-on-heroku.md)
* [Docker](en/installation/docker.md)
* [Development Mail Server](en/installation/dev_mailserver.md)
* [Mail Server Configuration](en/installation/mail_server_configuration.md)
* [Basic configuration](en/installation/basic_configuration.md)
* [CONSUL Documentation and guides](en/installation/documentation_and_guides.md)
@@ -75,7 +75,7 @@
* [Digital Ocean](es/installation/digital_ocean.md)
* [Heroku](es/installation/deploying-on-heroku.md)
* [Docker](es/installation/docker.md)
* [Servidor local de correo](es/installation/dev_mailserver.md)
* [Configuración del servidor de correo](es/installation/mail_server_configuration.md)
* [Configuración básica](es/installation/basic_configuration.md)
* [Documentación y guías sobre CONSUL](es/installation/documentation_and_guides.md)

View File

@@ -1,51 +0,0 @@
# Development Mail Server
This is a example to how integrate a mailing service with a development environment of Consul.
In this example we used [Mailgun](https://www.mailgun.com/).
## Create an account in Mailgun
![Creating an account in Mailgun](../../img/mailserver/mailgun-create-account.png)
* Skip the credit card form
* And activate your account with the link sent by email
## Domain configuration
* Go to the Domains section:
![Mailgun domain section](../../img/mailserver/mailgun-domains.png)
* Since you don't have a domain yet, you should click in the sandbox that is already created;
* Remember the next credentials:
![Mailgun sandbox](../../img/mailserver/mailgun-sandbox.png)
## Consul mailing configuration for development environment
* Go to `config/environments/development.rb` file;
* Add the lines on the file to configure the mail server:
``` ruby
config.action_mailer.delivery_method = :smtp
config.action_mailer.perform_deliveries = true
config.action_mailer.smtp_settings = {
:address => '',
:port => 2525,
:domain => '',
:user_name => '',
:password => '',
:authentication => :plain,
:enable_starttls_auto => true,
:ssl => false
}
```
* Fill, `address`, `domain`, `user_name`, `password` with your information. The file would look like:
![development.rb file](../../img/mailserver/development.rb.png)
## Consul mailing configuration for production environment
* Go to `config/environments/production.rb` file.
* Add the same **action mailer settings** configuration, but now with your production mail server information.
* Pay attention because you will need to change the **port** number to **587**.
You can also use Mailgun to production, adding your custom domain. Mailguns logs sent and delivered emails.

View File

@@ -0,0 +1,38 @@
# Mail Server Configuration
This is an example of how to integrate a mailing service with Consul.
In this example we use [Mailgun](https://www.mailgun.com/).
## Create an account in Mailgun
![Creating an account in Mailgun](../../img/mailserver/mailgun-create-account.png)
* Skip the credit card form
* And activate your account with the link sent by email
## Domain configuration
* Go to the Domains section: ![Mailgun domain section](../../img/mailserver/mailgun-domains.png)
* Since you don't have a domain yet, you should click in the sandbox that is already created
* Remember the following credentials: ![Mailgun sandbox](../../img/mailserver/mailgun-sandbox.png)
## Consul mailing configuration
* Go to the `config/secrets.yml` file
* Change the lines on the file to configure the mail server under the section `staging`, `preproduction` or `production`, depending on your setup:
```yml
mailer_delivery_method: :smtp
smtp_settings:
:address: "<smtp address>"
:port: 587
:domain: "<domain>"
:user_name: "<user_name>"
:password: "<password>"
:authentication: "plain"
:enable_starttls_auto: true
```
* Fill `<smtp address>`, `<domain>`, `<user_name>` and `<password>` with your information
* Save the file and restart your Consul application

View File

@@ -1,52 +0,0 @@
# Servidor de correo de desarrollo
Este es un ejemplo de cómo integrar un servicio de correo con un entorno de desarrollo de Consul.
En este ejemplo usamos a [Mailgun](https://www.mailgun.com/).
## Crear una cuenta en Mailgun
![Creando una cuenta en Mailgun](../../img/mailserver/mailgun-create-account.png)
* Omita el formulario de tarjeta de crédito
* Y active su cuenta con el enlace enviado por correo electrónico
## Configuración del domain
* Ve a la sección domain:
![Mailgun sección domain](../../img/mailserver/mailgun-domains.png)
* Como todavía no tienes un domain, debes hacer clic en el sandbox que ya está creado;
* Recuerde las próximas credenciales:
![Mailgun sandbox](../../img/mailserver/mailgun-sandbox.png)
## Configuración de correo del Consul para el entorno de desarrollo
* Vaya al archivo `config/environments/development.rb`;
* Agregue las líneas en el archivo para configurar el servidor de correo:
``` ruby
config.action_mailer.delivery_method = :smtp
config.action_mailer.perform_deliveries = true
config.action_mailer.smtp_settings = {
:address => '',
:port => 2525,
:domain => '',
:user_name => '',
:password => '',
:authentication => :plain,
:enable_starttls_auto => true,
:ssl => false
}
```
* Rellene, `address`, `domain`, `user_name`, `password` con su información. El archivo se vería así:
![archivo development.rb](../../img/mailserver/development.rb.png)
## Configuración de correo de Consul para el entorno de producción
* Vaya al archivo `config/environments/production.rb`;
* Agregue la misma configuración de **action mailer settings**, pero ahora con su información de servidor de correo de producción.
* Preste atención porque necesitará cambiar el número del **puerto** para **587**.
Puede usar Mailgun para producción también, agregando su dominio personalizado. Mailgun hay registros (logs) de los correos enviados y entregues.

View File

@@ -0,0 +1,38 @@
# Configuración del servidor de correo
Este es un ejemplo de cómo integrar un servicio de correo con Consul.
En este ejemplo usamos [Mailgun](https://www.mailgun.com/).
## Crear una cuenta en Mailgun
![Creando una cuenta en Mailgun](../../img/mailserver/mailgun-create-account.png)
* Puedes omitir el formulario de tarjeta de crédito
* Y activa tu cuenta con el enlace enviado por correo electrónico
## Configuración del dominio
* Ve a la sección "domain": ![Mailgun sección domain](../../img/mailserver/mailgun-domains.png)
* Como todavía no tienes un dominio, debes pinchar en el "sandbox" que ya está creado
* Recuerda las siguientes credenciales: ![Mailgun sandbox](../../img/mailserver/mailgun-sandbox.png)
## Configuración del correo en Consul
* Ve al archivo `config/secrets.yml`
* Modifica las líneas en el archivo para configurar el servidor de correo:
```yml
mailer_delivery_method: :smtp
smtp_settings:
:address: "<smtp address>"
:port: 587
:domain: "<domain>"
:user_name: "<user_name>"
:password: "<password>"
:authentication: "plain"
:enable_starttls_auto: true
```
* Rellena `<smtp address>`, `<domain>`, `<user_name>` y `<password>` con tu información.
* Guarda el fichero y reinicia tu aplicación Consul