Mengirim email dengan SendGrid

Tutorial ini menunjukkan cara menggunakan SendGrid untuk mengirim email dari aplikasi yang berjalan pada instance virtual machine (VM) Compute Engine.

Tujuan

• Menggunakan SendGrid dengan Postfix pada instance Compute Engine.
• Gunakan SendGrid dalam kode Java yang berjalan di instance Compute Engine.
• Gunakan SendGrid dalam kode Node.js yang berjalan di instance Compute Engine.
• Menggunakan SendGrid dengan server transportasi edge Microsoft Exchange pada instance Compute Engine.

Untuk informasi lainnya tentang cara menyiapkan SendGrid, lihat dokumentasi developer SendGrid.

Biaya

Di dokumen ini, Anda akan menggunakan komponen Google Cloudyang dapat ditagih berikut:

• Compute Engine

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga.

Pengguna Google Cloud baru mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Sebelum memulai

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. In the Google Cloud console, go to the Create an instance page.

   Go to Create an instance

2. Set Name to sendgrid-tutorial.
3. In the OS and Storage section, click Change to begin configuring your boot disk.
4. Di tab Public images, pilih a Debian or CentOS image version.
5. Klik Select.
6. Untuk membuat VM, klik Create.
7. Gunakan Google Cloud Marketplace untuk mendaftar ke layanan email SendGrid. Catat kredensial akun SMTP SendGrid Anda, yang mencakup nama pengguna, sandi, dan nama host. Nama pengguna dan sandi SMTP Anda sama dengan yang Anda gunakan untuk mendaftar ke layanan. Nama host SendGrid adalah smtp.sendgrid.net.
8. Membuat Kunci API:
   1. Login ke SendGrid dan buka Settings > API Keys.
   2. Membuat Kunci API.
   3. Pilih izin untuk kunci tersebut. Setidaknya, kunci harus memiliki izin Pengiriman email untuk mengirim email.
   4. Klik Save untuk membuat kunci.
   5. SendGrid akan membuat kunci baru. Ini adalah satu-satunya salinan kunci, jadi pastikan Anda menyalin kunci dan menyimpannya untuk nanti.

Mengirim email dari instance Anda dengan Postfix

Selesaikan langkah-langkah berikut untuk terhubung ke instance sendgrid-tutorial dan menjalankan SendGrid dengan Postfix.

Catatan: Dokumentasi SendGrid menyediakan sekumpulan petunjuk untuk penginstalan dan penyiapan Postfix. Jika Anda mengalami masalah saat menyiapkan Postfix dengan SendGrid, tinjau petunjuk SendGrid Postfix.

Hubungkan ke instance sendgrid-tutorial Anda menggunakan SSH

1. In the Google Cloud console, go to the VM instances page.

   Go to VM instances

2. In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

Mengonfigurasi SendGrid sebagai relai SMTP dengan Postfix

Jalankan perintah berikut di terminal SSH untuk menggunakan SendGrid sebagai relai SMTP dengan Postfix.

1. Menjadi superuser:

   sudo su -
   

2. Setel umask yang aman:

   umask 077
   

3. Instal Agen Transportasi Email Postfix:

   Debian

   apt update && apt -y install postfix libsasl2-modules

   CentOS

   yum install postfix cyrus-sasl-plain cyrus-sasl-md5 -y

   Jika diminta, pilih konfigurasi Local Only dan terima nama domain default.

4. Memodifikasi opsi konfigurasi Postfix. Buka /etc/postfix/main.cf untuk mengedit. Misalnya, untuk menggunakan editor teks nano, masukkan perintah berikut:

   nano /etc/postfix/main.cf
   

5. Perbarui file:

   1. Jadikan baris berikut sebagai komentar:

      # default_transport = error
      # relay_transport = error
      

   2. Tambahkan baris berikut ke bagian akhir file:

      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
      

      Baris di atas menerapkan dukungan SSL/TLS dan mengonfigurasi autentikasi SMTP untuk permintaan ini. Modul akses sederhana dan lapisan keamanan (SASL) menangani autentikasi dalam konfigurasi Postfix.

6. Simpan dan tutup file tersebut.

7. Buat peta sandi SASL menggunakan kunci API yang Anda buat di bagian Sebelum memulai. Ganti your-api-key dengan kunci API yang Anda buat.

   echo [smtp.sendgrid.net]:2525 apikey:your-api-key >> /etc/postfix/sasl_passwd

8. Gunakan utilitas postmap untuk menghasilkan file .db:

   postmap /etc/postfix/sasl_passwd
   

9. Verifikasi bahwa Anda memiliki file .db:

   ls -l /etc/postfix/sasl_passwd*
   

   -rw------- 1 root root    ...  /etc/postfix/sasl_passwd
   -rw------- 1 root root    ...  /etc/postfix/sasl_passwd.db
   

10. Hapus file yang berisi kredensial Anda karena tidak lagi diperlukan:

    rm /etc/postfix/sasl_passwd
    

11. Tetapkan izin pada file .db Anda dan pastikan file lainnya telah dihapus:

    chmod 600 /etc/postfix/sasl_passwd.db
    ls -la /etc/postfix/sasl_passwd*
    

    -rw------- 1 root root    ...  /etc/postfix/sasl_passwd.db
    

12. Muat ulang konfigurasi Anda untuk memuat parameter yang diubah:

    Debian

    /etc/init.d/postfix restart
    

    CentOS

    postfix reload
    

13. Instal paket mailutils atau mailx:

    Debian

    apt -y install mailutils

    CentOS

    yum install mailx -y
    

14. Kirim email uji:

    echo 'message' | mail -s subject [e-mail]

    Ganti kode berikut:

    • message: Isi email.
    • subject: Subjek email.
    • [e-mail]: Alamat email yang ingin Anda kirimi pesan.

    Buka log sistem Anda untuk melihat baris status yang berisi status dan kode respons server yang berhasil (250):

    Debian

    tail -n 5 /var/log/syslog
    

    CentOS

    tail -n 5 /var/log/maillog
    

Mengirim email dengan Java di instance Anda

Hubungkan ke instance sendgrid-tutorial Anda menggunakan SSH

1. In the Google Cloud console, go to the VM instances page.

   Go to VM instances

2. In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

Membuat dan mengirim pesan email

Petunjuk berikut menggunakan library klien Java SendGrid untuk membuat dan mengirim pesan email melalui SendGrid. Anda dapat melihat contoh lengkapnya di GitHub.

Di terminal SSH Anda:

1. Jadilah superuser dan setel umask yang aman:

   sudo su -
   umask 077
   

2. Instal Java dan Maven:

   apt -y update && apt -y install git-core openjdk-11-jdk maven
   

3. Clone GitHub repo:

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
   

4. Buka kode sumber utama untuk contoh:

   cd /root/java-docs-samples/compute/sendgrid/src/main/java/com/example/compute/sendgrid
   

5. Buka SendEmailServelet.java untuk mengedit.

   • Ganti your-sendgrid-api-key dengan kunci API untuk akun SendGrid Anda.

   • Ganti your-sendgrid-from-email dengan alamat email yang ingin Anda gunakan untuk mengirim email.

   • Ganti destination-email dengan alamat email yang ingin Anda kirimi email.

6. Buka direktori root kode contoh tersebut:

   cd /root/java-docs-samples/compute/sendgrid
   

7. Membuat class Java dalam paket:

   mvn clean package
   

8. Buka direktori target baru:

   cd target
   

9. Tetapkan izin yang memungkinkan Anda menjalankan file jar:

   chmod +x compute-sendgrid-1.0-SNAPSHOT-jar-with-dependencies.jar
   

10. Menjalankan pemilih versi Java alternatif:

    update-alternatives --config java
    

    Pilih opsi java-11-openjdk-amd64.

11. Jalankan file Java:

    java -jar compute-sendgrid-1.0-SNAPSHOT-jar-with-dependencies.jar
    

Mengirim email dengan Node.js di instance Anda

Untuk menjalankan contoh ini, Anda harus menginstal Node.js versi 7.6 atau yang lebih baru pada instance VM.[

Hubungkan ke instance sendgrid-tutorial Anda menggunakan SSH

1. In the Google Cloud console, go to the VM instances page.

   Go to VM instances

2. In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

Membuat dan mengirim pesan email

Di terminal SSH Anda:

1. Jadilah superuser dan setel umask yang aman:

   sudo su -
   umask 077
   

2. Perbarui repositori paket Anda:

   Debian

   apt update
   

   CentOS

   yum update -y
   

3. Instal dependensi 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
   

4. Instal Node.js. Secara default, penginstalan juga akan menginstal 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 -
   

   Kemudian, instal Node.js:

   yum -y install nodejs
   

5. Instal klien SendGrid Node.js:

   npm install sendgrid
   

6. Gandakan repositori sampel

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
   

7. Buka direktori yang berisi contoh SendGrid:

   cd nodejs-docs-samples/compute
   

8. Salin file sendgrid.js:

   cp sendgrid.js sendmail.js
   

9. Buka sendmail.js untuk mengedit.

   • Ganti your-sendgrid-api-key dengan kunci API untuk akun SendGrid Anda.

   • Ganti [e-mail] dengan alamat email yang ingin Anda gunakan untuk mengirim email.

   • Ganti [e-mail] dengan alamat email yang ingin Anda kirimi email.

   // This sample is based off of:
   // https://github.com/sendgrid/sendgrid-nodejs/tree/master/packages/mail
   const sendgrid = require('@sendgrid/mail');
   sendgrid.setApiKey(process.env.SENDGRID_API_KEY || '<your-sendgrid-api-key>');
   
   async function sendgridExample() {
     await sendgrid.send({
       to: '[e-mail]',
       from: '[e-mail]',
       subject: 'Sendgrid test email from Node.js on Google Cloud Platform',
       text: 'Well hello! This is a Sendgrid test email from Node.js on Google Cloud Platform.',
     });
   }
   sendgridExample();

10. Jalankan program untuk mengirim pesan email melalui SendGrid:

    node sendmail.js
    

Mengirim email dari server transpor edge Exchange

Anda dapat menyiapkan Microsoft Exchange untuk mengirim email keluar menggunakan SendGrid dengan mengonfigurasi konektor pengiriman keluar. Untuk mengetahui detailnya, lihat Men-deploy Microsoft Exchange Server 2016 di Compute Engine.

Pembersihan

Agar tidak perlu membayar biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus setiap resource.

Menghapus project

Cara termudah untuk menghilangkan penagihan adalah dengan menghapus project yang Anda buat untuk tutorial.

Untuk menghapus project:

Perhatian: Penghapusan project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika Anda menggunakan project Anda sendiri untuk mengerjakan tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin Anda gunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Menghapus instance Compute Engine

Untuk menghapus instance Compute Engine:

1. In the Google Cloud console, go to the VM instances page.

   Go to VM instances

2. Select the checkbox for your sendgrid-tutorial instance.
3. To delete the instance, click More actions, click Delete, and then follow the instructions.

Langkah berikutnya

Pelajari arsitektur referensi, diagram, dan praktik terbaik tentang Google Cloud. Lihat Cloud Architecture Center kami.