Added documentation page EN/ES to mail server #30
This commit is contained in:
@@ -14,6 +14,7 @@
|
||||
* [macOS](getting_started/prerequisites/macos.md)
|
||||
* [Windows](getting_started/prerequisites/windows.md)
|
||||
* [Local installation](getting_started/installation.md)
|
||||
* [Development Mail Server](getting_started/dev_mailserver.md)
|
||||
* [Production and Test servers](getting_started/servers.md)
|
||||
* [Recomendations](getting_started/recomendations.md)
|
||||
|
||||
|
||||
51
docs/en/getting_started/dev_mailserver.md
Normal file
51
docs/en/getting_started/dev_mailserver.md
Normal file
@@ -0,0 +1,51 @@
|
||||
# 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
|
||||
|
||||

|
||||
|
||||
* Skip the credit card form
|
||||
* And activate your account with the link sent by email
|
||||
|
||||
|
||||
## Domain configuration
|
||||
* Go to the Domains section:
|
||||

|
||||
|
||||
* Since you don't have a domain yet, you should click in the sandbox that is already created;
|
||||
* Remember the next credentials:
|
||||

|
||||
|
||||
## 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:
|
||||
|
||||

|
||||
|
||||
## 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. Mailgun’s logs sent and delivered emails.
|
||||
@@ -14,6 +14,7 @@
|
||||
* [macOS](getting_started/prerequisites/macos.md)
|
||||
* [Windows](getting_started/prerequisites/windows.md)
|
||||
* [Instalación local](getting_started/installation.md)
|
||||
* [Servidor local de correo](getting_started/dev_mailserver.md)
|
||||
* [Servidores de prueba y producción](getting_started/servers.md)
|
||||
* [Recomendaciones](getting_started/recomendations.md)
|
||||
|
||||
|
||||
52
docs/es/getting_started/dev_mailserver.md
Normal file
52
docs/es/getting_started/dev_mailserver.md
Normal file
@@ -0,0 +1,52 @@
|
||||
# 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
|
||||
|
||||

|
||||
|
||||
* 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:
|
||||

|
||||
|
||||
* Como todavía no tienes un domain, debes hacer clic en el sandbox que ya está creado;
|
||||
* Recuerde las próximas credenciales:
|
||||

|
||||
|
||||
## 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í:
|
||||
|
||||

|
||||
|
||||
## 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.
|
||||
BIN
docs/img/development.rb.png
Normal file
BIN
docs/img/development.rb.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 42 KiB |
BIN
docs/img/mailgun-create-account.png
Normal file
BIN
docs/img/mailgun-create-account.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 40 KiB |
BIN
docs/img/mailgun-domains.png
Normal file
BIN
docs/img/mailgun-domains.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 33 KiB |
BIN
docs/img/mailgun-sandbox.png
Normal file
BIN
docs/img/mailgun-sandbox.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 58 KiB |
Reference in New Issue
Block a user