En este instructivo, se muestra cómo usar SendGrid para enviar correos electrónicos desde una aplicación que se ejecuta en una instancia de máquina virtual (VM) de Compute Engine.
Objetivos
- Usar SendGrid con Postfix en una instancia de Compute Engine
- Usar SendGrid en código Java que se ejecuta en una instancia de Compute Engine
- Usar SendGrid en código Node.js que se ejecuta en una instancia de Compute Engine
- Usar SendGrid con un servidor de transporte perimetral de Microsoft Exchange en una instancia de Compute Engine
Si quieres obtener más información sobre la configuración de SendGrid, consulta la documentación para desarrolladores de SendGrid.
Costos
En este documento, usarás los siguientes componentes facturables de Google Cloud:
- Compute Engine
Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.
Antes de comenzar
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
- In the Google Cloud console, go to the Create an instance page.
-
Set Name to
sendgrid-tutorial
. - In the Boot disk section, click Change to begin configuring your boot disk.
- En la pestaña Public images, selecciona a Debian or CentOS image version.
- Haz clic en Seleccionar.
- Para crear la VM, haz clic en Crear.
-
Usa Google Cloud Marketplace para registrarte en el servicio de correo electrónico de SendGrid. Toma nota de las credenciales de tu cuenta SMTP de SendGrid, que incluyen el nombre de usuario, contraseña y nombre de host. Tu nombre de usuario y contraseña de SMTP son los mismos que usaste para registrarte en el servicio. El nombre de host de SendGrid es
smtp.sendgrid.net
. - Crea una clave de API de la manera siguiente:
- Accede a Sendgrid y ve a Configuración > Claves de API.
- Crea una clave de API.
- Selecciona los permisos de la clave. La clave debe tener como mínimo permisos de envío de correo electrónico para enviar correos electrónicos.
- Haz clic en Guardar para crear la clave.
- SendGrid genera una clave nueva. Esta es la única copia de la clave, así que asegúrate de copiarla y guardarla para más adelante.
Envía correos desde tu instancia con Postfix
Completa los siguientes pasos para conectarte a tu instancia de sendgrid-tutorial y ejecutar SendGrid con Postfix.
Conéctate a la instancia de sendgrid-tutorial a través de SSH
- En la consola de Google Cloud, ve a la página Instancias de VM.
- En la lista de instancias de máquinas virtuales, haz clic en SSH en la fila de la instancia a la que deseas conectarte.
Configura SendGrid como una retransmisión de SMTP con Postfix
Ejecuta los siguientes comandos en la terminal de SSH para usar SendGrid como retransmisión de SMTP con Postfix.
Conviértete en superusuario:
sudo su -
Establece una máscara de seguridad:
umask 077
Instala el agente de transporte de correos Postfix:
Debian
apt update && apt -y install postfix libsasl2-modules
CentOS
yum install postfix cyrus-sasl-plain cyrus-sasl-md5 -y
Si se te solicita, selecciona la configuración Solo local y acepta el nombre de dominio predeterminado.
Modifica las opciones de configuración de Postfix. Abre
/etc/postfix/main.cf
para edición. Por ejemplo, para usar el editor de textonano
, ingresa el comando siguiente:nano /etc/postfix/main.cf
Actualiza el archivo:
Comenta las siguientes líneas:
# default_transport = error # relay_transport = error
Agrega las siguientes líneas al final del archivo:
relayhost = [smtp.sendgrid.net]:2525 smtp_tls_security_level = encrypt smtp_sasl_auth_enable = yes smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd header_size_limit = 4096000 smtp_sasl_security_options = noanonymous
Las líneas anteriores aplican la compatibilidad con SSL/TLS y configuran la autenticación SMTP para estas solicitudes. Un módulo simple de acceso y capa de seguridad (SASL) maneja la autenticación en la configuración de Postfix.
Guarda y cierra el archivo.
Genera el mapa de contraseña SASL mediante la clave de API que generaste en la sección Antes de comenzar. Reemplaza
your-api-key
por la clave de API que generaste.echo [smtp.sendgrid.net]:2525 apikey:your-api-key >> /etc/postfix/sasl_passwd
Usa la utilidad
postmap
para generar un archivo.db
:postmap /etc/postfix/sasl_passwd
Verifica que tengas un archivo
.db
de la manera siguiente:ls -l /etc/postfix/sasl_passwd*
-rw------- 1 root root ... /etc/postfix/sasl_passwd -rw------- 1 root root ... /etc/postfix/sasl_passwd.db
Quita el archivo que contiene tus credenciales, ya que no lo necesitarás con el comando siguiente:
rm /etc/postfix/sasl_passwd
Configura los permisos en tu archivo
.db
y verifica que el otro archivo se haya quitado de la manera siguiente:chmod 600 /etc/postfix/sasl_passwd.db ls -la /etc/postfix/sasl_passwd*
-rw------- 1 root root ... /etc/postfix/sasl_passwd.db
Vuelve a cargar la configuración para cargar los parámetros modificados con los siguientes comandos:
Debian
/etc/init.d/postfix restart
CentOS
postfix reload
Instala el paquete
mailutils
omailx
con los comandos siguientes:Debian
apt -y install mailutils
CentOS
yum install mailx -y
Envía un correo electrónico de prueba mediante el siguiente comando:
echo 'message' | mail -s subject [email protected]
Reemplaza lo siguiente:
message
: El cuerpo del correo electrónicosubject
: El asunto del correo electrónico[email protected]
: La dirección de correo electrónico a la que deseas enviar un mensaje
Busca en tus registros de sistema una línea de estado que contenga
status
y el código de respuesta correcto del servidor(250)
:Debian
tail -n 5 /var/log/syslog
CentOS
tail -n 5 /var/log/maillog
Envía un correo electrónico con Java en tu instancia
Conéctate a la instancia de sendgrid-tutorial a través de SSH
- En la consola de Google Cloud, ve a la página Instancias de VM.
- En la lista de instancias de máquinas virtuales, haz clic en SSH en la fila de la instancia a la que deseas conectarte.
Crea y envía un mensaje de correo electrónico
En las siguientes instrucciones, se usa la biblioteca cliente de Java de SendGrid para crear y enviar un mensaje de correo electrónico a través de SendGrid. Puedes ver el ejemplo completo en GitHub.
En tu terminal de SSH, realiza los siguientes pasos:
Conviértete en superusuario y establece una máscara de seguridad:
sudo su - umask 077
Instala Java y Maven:
apt -y update && apt -y install git-core openjdk-11-jdk maven
Clona el repositorio de GitHub:
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
Ve al ejemplo en el código fuente principal:
cd /root/java-docs-samples/compute/sendgrid/src/main/java/com/example/compute/sendgrid
Abre
SendEmailServelet.java
para edición.Reemplaza
your-sendgrid-api-key
por la clave de API para tu cuenta de SendGrid.Reemplaza
your-sendgrid-from-email
por la dirección de correo electrónico desde la que deseas enviar un correo electrónico.Reemplaza
destination-email
por la dirección de correo electrónico a la que deseas enviar un correo electrónico.
Ve al directorio raíz del código de muestra:
cd /root/java-docs-samples/compute/sendgrid
Empaqueta la clase Java:
mvn clean package
Ve al directorio
target
nuevo con el comando siguiente:cd target
Establece permisos que te permitan ejecutar el archivo jar:
chmod +x compute-sendgrid-1.0-SNAPSHOT-jar-with-dependencies.jar
Ejecuta el selector de versión alternativa de Java con el siguiente comando:
update-alternatives --config java
Selecciona la opción
java-11-openjdk-amd64
.Ejecuta el archivo Java con el comando siguiente:
java -jar compute-sendgrid-1.0-SNAPSHOT-jar-with-dependencies.jar
Envía correos electrónicos con Node.js en tu instancia
Para ejecutar este ejemplo, debes tener la versión 7.6 o posterior de Node.js
instalada en la instancia de VM.
Conéctate a la instancia de sendgrid-tutorial a través de SSH
- En la consola de Google Cloud, ve a la página Instancias de VM.
- En la lista de instancias de máquinas virtuales, haz clic en SSH en la fila de la instancia a la que deseas conectarte.
Crea y envía un mensaje de correo electrónico
En tu terminal de SSH, realiza los siguientes pasos:
Conviértete en superusuario y establece una máscara de seguridad:
sudo su - umask 077
Actualiza los repositorios de tus paquetes:
Debian
apt update
CentOS
yum update -y
Instala las dependencias de Node.js:
Debian
apt -y install git-core curl build-essential openssl libssl-dev
CentOS
yum install git-core curl openssl openssl-devel -y yum groupinstall "Development Tools" -y
Instala Node.js. De forma predeterminada, la instalación también instala npm:
Debian
curl -sL https://deb.nodesource.com/setup_14.x | sudo bash - sudo apt -y install nodejs
CentOS
curl --silent --location https://rpm.nodesource.com/setup_14.x | bash -
Luego, instala Node.js:
yum -y install nodejs
Instala el cliente Node.js de SendGrid:
npm install sendgrid
Clona el repositorio de muestra:
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
Ve al directorio que contiene la muestra de SendGrid con el comando siguiente:
cd nodejs-docs-samples/compute
Copia el archivo
sendgrid.js
con el comando siguiente:cp sendgrid.js sendmail.js
Abre
sendmail.js
para edición.Reemplaza
your-sendgrid-api-key
por la clave de API para tu cuenta de SendGrid.Reemplaza
[email protected]
por la dirección de correo electrónico desde la que deseas enviar un correo electrónico.Reemplaza
[email protected]
por la dirección de correo electrónico a la que deseas enviar un correo electrónico.
Ejecuta el programa para enviar un mensaje de correo electrónico a través de SendGrid:
node sendmail.js
Envía correos electrónicos desde un servidor de transporte perimetral de Exchange
Puedes configurar Microsoft Exchange para enviar correos electrónicos salientes con SendGrid mediante la configuración de un conector de envío saliente. Para obtener más detalles, consulta Implementa Microsoft Exchange Server 2016 en Compute Engine.
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.
Borra el proyecto
La manera más fácil de eliminar la facturación es borrar el proyecto que creaste para el instructivo.
Para borrar el proyecto, sigue estos pasos:
- En la consola de Google Cloud, ve a la página Administrar recursos.
- En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
- En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.
Borra tu instancia de Compute Engine
Para borrar una instancia de Compute Engine, sigue estos pasos:
- En la consola de Google Cloud, ve a la página Instancias de VM.
-
Selecciona tu instancia
sendgrid-tutorial
en la casilla de verificación de . - Para borrar la instancia, haz clic en Más acciones, haz clic en Borrar y, luego, sigue las instrucciones.
¿Qué sigue?
Explora arquitecturas de referencia, diagramas y prácticas recomendadas sobre Google Cloud. Consulta nuestro Cloud Architecture Center.