Mulai menggunakan Go

Men-deploy aplikasi Anda ke Cloud Run

Cloud de Confiance menawarkan beberapa opsi untuk menjalankan kode Anda. Untuk contoh ini, Anda menggunakan Cloud Run untuk men-deploy aplikasi yang skalabel ke Cloud de Confiance. Cloud Run tidak mengharuskan Anda mengelola server dan otomatis menskalakan untuk mendukung lonjakan traffic.

1. Jalankan container dengan Cloud Run:

   gcloud run deploy bookshelf --region us-central1 --allow-unauthenticated \
   --set-env-vars="GOOGLE_CLOUD_PROJECT=PROJECT_ID" --source .

   Aplikasi Anda kini dapat dilihat di URL yang ditampilkan dalam output gcloud run:

   Service [bookshelf] revision [bookshelf-00001] has been deployed and is serving 100 percent of traffic.
   Service URL: https://bookshelf-swsmmh5s5a-uc.a.run.app
   

2. Salin URL ke browser web Anda untuk melihat aplikasi.

Untuk mengetahui informasi selengkapnya tentang men-deploy ke Cloud Run, lihat dokumentasi Cloud Run.

Mempertahankan data Anda dengan Firestore

Anda tidak dapat menyimpan informasi di instance Cloud Run, karena informasi tersebut akan hilang jika instance dimulai ulang, dan tidak ada saat instance baru dibuat. Sebagai gantinya, Anda menggunakan database yang dibaca dan ditulis oleh semua instance Anda.

Cloud de Confiance menawarkan beberapa opsi untuk menyimpan data Anda. Dalam contoh ini, Anda menggunakan Firestore untuk menyimpan data setiap buku. Firestore adalah database dokumen NoSQL tanpa server yang terkelola sepenuhnya yang memungkinkan Anda menyimpan dan membuat kueri data. Firestore menskalakan otomatis untuk memenuhi kebutuhan aplikasi Anda, dan menskalakan ke nol saat Anda tidak menggunakannya. Tambahkan buku pertama Anda sekarang.

1. Untuk membuat buku bagi aplikasi yang di-deploy, klik Tambahkan buku.

   
2. Di kolom Title, masukkan Moby Dick.
3. Pada kolom Author, masukkan Herman Melville.

4. Klik Simpan. Sekarang ada entri ke aplikasi Bookshelf Anda.

   
5. Di konsol Cloud de Confiance , untuk memuat ulang halaman Firestore, klik Muat ulang refresh. Data akan muncul di Firestore. Aplikasi Bookshelf menyimpan setiap buku sebagai dokumen Firestore dengan ID unik, dan semua dokumen ini disimpan dalam koleksi Firestore. Untuk tujuan tutorial ini, koleksinya disebut buku.

Firestore menyimpan buku menggunakan Library Klien Firestore. Berikut adalah contoh pengambilan dokumen Firestore:

// newFirestoreDB creates a new BookDatabase backed by Cloud Firestore.
// See the firestore package for details on creating a suitable
// firestore.Client: https://godoc.org/cloud.google.com/go/firestore.
func newFirestoreDB(client *firestore.Client) (*firestoreDB, error) {
	ctx := context.Background()
	// Verify that we can communicate and authenticate with the Firestore
	// service.
	err := client.RunTransaction(ctx, func(ctx context.Context, t *firestore.Transaction) error {
		return nil
	})
	if err != nil {
		return nil, fmt.Errorf("firestoredb: could not connect: %w", err)
	}
	return &firestoreDB{
		client:     client,
		collection: "books",
	}, nil
}

// Close closes the database.
func (db *firestoreDB) Close(context.Context) error {
	return db.client.Close()
}

// Book retrieves a book by its ID.
func (db *firestoreDB) GetBook(ctx context.Context, id string) (*Book, error) {
	ds, err := db.client.Collection(db.collection).Doc(id).Get(ctx)
	if err != nil {
		return nil, fmt.Errorf("firestoredb: Get: %w", err)
	}
	b := &Book{}
	ds.DataTo(b)
	return b, nil
}

Untuk mengetahui informasi selengkapnya tentang penggunaan Firestore, lihat artikel Menambahkan data ke Firestore.

Menyimpan upload file di Cloud Storage

Setelah menambahkan buku, saatnya menambahkan gambar sampul buku. Anda tidak dapat menyimpan file di instance Anda. Database bukan pilihan yang tepat untuk file gambar. Sebagai gantinya, Anda akan menggunakan Cloud Storage.

Cloud Storage adalah penyimpanan blob utama untuk Cloud de Confiance. Anda dapat menggunakan Cloud Storage untuk menghosting aset aplikasi yang ingin Anda bagikan di seluruh Cloud de Confiance. Untuk menggunakan Cloud Storage, Anda harus membuat bucket Cloud Storage, yaitu container dasar untuk menyimpan data Anda.

1. Di konsol Cloud de Confiance , buka halaman Browser Cloud Storage.

   Buka halaman Browser Cloud Storage

2. Klik Create bucket.
3. Di dialog Buat bucket, masukkan nama untuk bucket Anda dengan menambahkan project ID Cloud de Confiance ke string _bucket sehingga nama bucket terlihat seperti YOUR_PROJECT_ID_bucket. Nama ini tunduk pada persyaratan nama bucket. Semua kolom lainnya dapat tetap pada nilai defaultnya.
4. Klik Buat.
5. Setelah bucket Anda dibuat, objek harus dibuat agar dapat diakses secara publik agar dapat dilihat oleh pengguna. Untuk membuat objek Anda dapat diakses secara publik, lihat Membuat Data Publik.
6. Klik Edit buku, lalu pilih gambar untuk diupload sebagai sampul buku Anda. Misalnya, Anda dapat menggunakan gambar domain publik ini:
   
7. Klik Simpan. Anda akan dialihkan ke halaman beranda, tempat terdapat entri ke aplikasi Bookshelf Anda.
   

Aplikasi rak buku mengirimkan file yang diupload ke Cloud Storage menggunakan Cloud Storage Client Library.

// uploadFileFromForm uploads a file if it's present in the "image" form field.
func (b *Bookshelf) uploadFileFromForm(ctx context.Context, r *http.Request) (url string, err error) {
	f, fh, err := r.FormFile("image")
	if err == http.ErrMissingFile {
		return "", nil
	}
	if err != nil {
		return "", err
	}

	if b.StorageBucket == nil {
		return "", errors.New("storage bucket is missing: check bookshelf.go")
	}
	if _, err := b.StorageBucket.Attrs(ctx); err != nil {
		if err == storage.ErrBucketNotExist {
			return "", fmt.Errorf("bucket %q does not exist: check bookshelf.go", b.StorageBucketName)
		}
		return "", fmt.Errorf("could not get bucket: %w", err)
	}

	// random filename, retaining existing extension.
	name := uuid.Must(uuid.NewV4()).String() + path.Ext(fh.Filename)

	w := b.StorageBucket.Object(name).NewWriter(ctx)

	// Warning: storage.AllUsers gives public read access to anyone.
	w.ACL = []storage.ACLRule{{Entity: storage.AllUsers, Role: storage.RoleReader}}
	w.ContentType = fh.Header.Get("Content-Type")

	// Entries are immutable, be aggressive about caching (1 day).
	w.CacheControl = "public, max-age=86400"

	if _, err := io.Copy(w, f); err != nil {
		return "", err
	}
	if err := w.Close(); err != nil {
		return "", err
	}

	const publicURL = "https://storage.googleapis.com/%s/%s"
	return fmt.Sprintf(publicURL, b.StorageBucketName, name), nil
}

Untuk mengetahui informasi selengkapnya tentang cara menggunakan Cloud Storage, lihat pengantar Cloud Storage.

Memantau aplikasi Anda menggunakan Google Cloud Observability

Anda telah men-deploy aplikasi, serta membuat dan mengubah buku. Untuk memantau peristiwa ini bagi pengguna Anda, gunakan Pengelolaan Performa Aplikasi.

Memantau log dengan Cloud Logging

1. Di Cloud de Confiance, buka Logs Explorer

   Buka Logs Explorer

   Anda dapat memantau aplikasi secara real time. Jika Anda mengalami masalah dengan aplikasi Anda, ini adalah salah satu tempat pertama yang harus dilihat.

   
2. Di menu drop-down Resource, pilih Cloud Run Revision, bookshelf.

Pantau kesalahan menggunakan Pelaporan Kesalahan

1. Di konsol Cloud de Confiance , buka halaman Error Reporting.
   Buka halaman Error Reporting
   Error Reporting menyoroti error dan pengecualian dalam aplikasi Anda dan memungkinkan Anda menyiapkan pemberitahuan terkait error dan pengecualian tersebut.
2. Di browser Anda, buka URL /errors di aplikasi Anda.
   

   YOUR_CLOUD_RUN_URL/errors

   Tindakan ini akan menghasilkan pengecualian pengujian baru dan mengirimkannya ke Google Cloud Observability.

3. Di konsol Cloud de Confiance , kembali ke halaman Error Reporting, dan dalam beberapa saat, error baru akan terlihat. Klik Muat Ulang Otomatis agar Anda tidak perlu memuat ulang halaman secara manual.