Catatan: Go 1.11 telah mencapai akhir dukungan pada 30 Januari 2024. Aplikasi Go 1.11 Anda yang sudah ada akan terus berjalan dan menerima traffic. Namun, App Engine mungkin memblokir deployment ulang aplikasi yang menggunakan runtime setelah akhir tanggal dukungannya. Sebaiknya migrasikan ke versi Go terbaru yang didukung.

Menyimpan data ke dalam cache dengan Memorystore

Aplikasi web berperforma tinggi yang skalabel sering menggunakan cache data dalam memori yang terdistribusi di depan atau sebagai pengganti penyimpanan persisten yang kuat untuk beberapa tugas. Sebaiknya gunakan Memorystore for Redis sebagai layanan penyimpanan data ke dalam cache. Perlu diketahui bahwa Memorystore for Redis tidak menyediakan paket gratis. Lihat Harga Memorystore untuk mengetahui detail selengkapnya.

Sebelum memulai, pastikan aplikasi Anda tidak melebihi kuota Memorystore for Redis.

Waktu penggunaan cache memori

Data sesi, preferensi pengguna, dan data lain yang ditampilkan oleh kueri untuk halaman web adalah pilihan yang baik untuk disimpan ke dalam cache. Secara umum, jika kueri yang sering dijalankan menampilkan serangkaian hasil yang tidak harus segera muncul di aplikasi, Anda dapat menyimpan hasilnya ke dalam cache. Permintaan berikutnya dapat memeriksa cache dan hanya membuat kueri database jika hasilnya tidak ada atau sudah tidak berlaku.

Jika Anda hanya menyimpan nilai di Memorystore tanpa mencadangkannya di penyimpanan persisten, pastikan aplikasi Anda memiliki perilaku yang dapat diterima jika nilainya sudah tidak berlaku dan dihapus dari cache. Misalnya, sesi akan gagal berfungsi jika secara tiba-tiba data sesi pengguna tidak tersedia. Oleh karena itu, data tersebut mungkin harus disimpan dalam database selain Memorystore.

Memahami izin Memorystore

Setiap interaksi dengan layanan Google Cloud perlu diotorisasi. Misalnya, untuk berinteraksi dengan database Redis yang dihosting oleh Memorystore, aplikasi Anda harus menyediakan kredensial akun yang memiliki otorisasi untuk mengakses Memorystore.

Secara default, aplikasi Anda akan memberikan kredensial akun layanan default App Engine, yang memiliki otorisasi untuk mengakses database dalam project yang sama dengan aplikasi Anda.

Jika salah satu kondisi berikut terpenuhi, Anda harus menggunakan teknik autentikasi alternatif yang secara eksplisit memberikan kredensial:

Aplikasi Anda dan database Memorystore berada di project Google Cloud yang berbeda.
Anda telah mengubah peran yang ditetapkan ke akun layanan App Engine default.

Untuk mengetahui informasi tentang teknik autentikasi alternatif, lihat Menyiapkan Autentikasi untuk Aplikasi Produksi Server ke Server.

Ringkasan penggunaan Memorystore

Untuk menggunakan Memorystore di aplikasi Anda:

Siapkan Memorystore for Redis, yang mengharuskan Anda untuk membuat instance Redis pada Memorystore dan membuat Akses VPC Serverless yang digunakan aplikasi Anda untuk berkomunikasi dengan instance Redis. Urutan pembuatan dua entity independen ini tidak wajib diikuti dan dapat disiapkan dalam urutan apa pun. Petunjuk dalam panduan ini menunjukkan penyiapan Akses VPC Serverless terlebih dahulu.
Instal library klien untuk Redis dan gunakan perintah Redis untuk menyimpan data ke dalam cache.

Memorystore for Redis kompatibel dengan library klien mana pun untuk Redis. Panduan ini menjelaskan penggunaan library klien redigo untuk mengirim perintah Redis dari aplikasi Anda.
Uji pembaruan Anda.
Deploy aplikasi Anda ke App Engine.

Menyiapkan Memorystore for Redis

Untuk menyiapkan Memorystore for Redis:

Hubungkan App Engine Anda ke jaringan VPC. Aplikasi Anda hanya dapat berkomunikasi dengan Memorystore melalui konektor VPC.

Pastikan untuk menambahkan informasi koneksi VPC ke file app.yaml Anda, seperti yang dijelaskan dalam Mengonfigurasi aplikasi menggunakan konektor.
Catat alamat IP dan nomor port instance Redis yang Anda buat. Anda akan menggunakan informasi ini saat membuat klien Redis dalam kode.
Buat instance Redis di Memorystore.

Saat diminta memilih region untuk instance Redis, pilih region yang sama dengan lokasi aplikasi App Engine Anda berada.

Menginstal dependensi

Agar library klien redigo tersedia untuk aplikasi Anda saat dijalankan di App Engine, tambahkan library ke dependensi aplikasi Anda. Misalnya, jika Anda menggunakan file go.mod untuk mendeklarasikan dependensi, tambahkan baris berikut ke file go.mod Anda:

module github.com/GoogleCloudPlatform/golang-samples/tree/master/memorystore/redis

Pelajari lebih lanjut cara menentukan dependensi untuk aplikasi Go Anda.

Membuat klien Redis

Untuk berinteraksi dengan database Redis, kode Anda perlu membuat klien Redis untuk mengelola koneksi ke database Redis. Bagian berikut menjelaskan pembuatan klien Redis menggunakan library klien redigo.

Menentukan variabel lingkungan

Library klien redigo menggunakan dua variabel lingkungan untuk menyusun URL bagi database Redis Anda:

Variabel untuk mengidentifikasi alamat IP database Redis yang Anda buat di Memorystore.
Variabel untuk mengidentifikasi nomor port database Redis yang Anda buat di Memorystore.

Sebaiknya tentukan variabel ini dalam file app.yaml aplikasi, bukan menentukannya secara langsung di dalam kode. Cara ini memudahkan Anda untuk menjalankan aplikasi di lingkungan yang berbeda, seperti lingkungan lokal dan App Engine.

Misalnya, tambahkan baris berikut ke file app.yaml Anda:

 env_variables:
      REDISHOST: '10.112.12.112'
      REDISPORT: '6379'

Mengimpor redigo dan membuat klien

Setelah Anda menentukan variabel lingkungan REDISHOST dan REDISPORT, gunakan baris berikut untuk mengimpor library redigo, membuat kumpulan koneksi, lalu mengambil klien Redis dari kumpulan tersebut:


// Command redis is a basic app that connects to a managed Redis instance.
package main

import (
	"fmt"
	"log"
	"net/http"
	"os"

	"github.com/gomodule/redigo/redis"
)

var redisPool *redis.Pool

func incrementHandler(w http.ResponseWriter, r *http.Request) {
	conn := redisPool.Get()
	defer conn.Close()

	counter, err := redis.Int(conn.Do("INCR", "visits"))
	if err != nil {
		http.Error(w, "Error incrementing visitor counter", http.StatusInternalServerError)
		return
	}
	fmt.Fprintf(w, "Visitor number: %d", counter)
}

func main() {
	redisHost := os.Getenv("REDISHOST")
	redisPort := os.Getenv("REDISPORT")
	redisAddr := fmt.Sprintf("%s:%s", redisHost, redisPort)

	const maxConnections = 10
	redisPool = &redis.Pool{
		MaxIdle: maxConnections,
		Dial:    func() (redis.Conn, error) { return redis.Dial("tcp", redisAddr) },
	}

	http.HandleFunc("/", incrementHandler)

	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}
	log.Printf("Listening on port %s", port)
	if err := http.ListenAndServe(":"+port, nil); err != nil {
		log.Fatal(err)
	}
}

Menggunakan perintah Redis untuk menyimpan dan mengambil data dalam cache

Meskipun database Memorystore Redis mendukung sebagian besar perintah Redis, Anda hanya perlu menggunakan beberapa perintah untuk menyimpan dan mengambil data dari cache. Tabel berikut menampilkan rekomendasi perintah Redis yang dapat Anda gunakan untuk menyimpan data ke dalam cache. Untuk mengetahui cara memanggil perintah tersebut dari aplikasi Anda, lihat dokumentasi library klien.

Tugas	Perintah Redis
Buat entri dalam cache data dan tetapkan waktu habis masa berlaku untuk entri	SETNX MSETNX
Mengambil data dari cache	GET MGET
Mengganti nilai cache yang ada	SETEL MSET
Menambahkan atau mengurangi nilai cache numerik	INCR INCRBY DECR DECRBY
Menghapus entri dari cache	DEL UNLINK
Mendukung interaksi serentak dengan cache	Lihat detail tentang transaksi Redis.

Menguji update Anda

Saat Anda menguji aplikasi secara lokal, pertimbangkan untuk menjalankan instance lokal Redis gun menghindari interaksi dengan data produksi (Memorystore tidak menyediakan emulator). Untuk menginstal dan menjalankan Redis secara lokal, ikuti petunjuk dalam dokumentasi Redis. Perhatikan bahwa saat ini menjalankan Redis secara lokal di Windows tidak dapat dilakukan.

Men-deploy aplikasi Anda

Setelah aplikasi Anda berjalan di server pengembangan lokal tanpa error:

Uji aplikasi di App Engine.
Jika aplikasi berjalan tanpa error, gunakan pemisahan traffic untuk meningkatkan traffic secara perlahan untuk aplikasi yang telah diupdate. Pantau aplikasi dengan cermat untuk menemukan masalah database apa pun sebelum mengarahkan lebih banyak traffic ke aplikasi yang telah diupdate.