Comienza a usar Go

Implementa tu app en Cloud Run

Cloud de Confiance ofrece varias opciones para ejecutar tu código. Para este ejemplo, usa Cloud Run para implementar una app escalable en Cloud de Confiance. Cloud Run no requiere que administres servidores ni se escala de forma automática para admitir los aumentos de tráfico.

1. Ejecuta el contenedor con Cloud Run:

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

   Ahora tu app se puede ver en la URL que se muestra en el resultado de 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. Copia la URL a tu navegador web para ver la app.

Para obtener más información sobre la implementación en Cloud Run, consulta la documentación de Cloud Run.

Almacena tus datos con Firestore

No se puede almacenar información en tus instancias de Cloud Run porque se perderá si se reinicia la instancia, además de que no existirá cuando se creen instancias nuevas. En su lugar, usarás una base de datos en la que todas tus instancias puedan leer y escribir.

Cloud de Confiance ofrece varias opciones para almacenar tus datos. En este ejemplo, usarás Firestore para almacenar los datos de cada libro. Firestore es una base de datos de documentos NoSQL, completamente administrada y sin servidores que te permite almacenar y consultar datos. Firestore escala de manera automática para cumplir las necesidades de tu aplicación y escala a cero cuando no la estás usando. Agrega el primer libro:

1. Para crear un libro en tu aplicación implementada, haz clic en Add book (Agregar libro).

   
2. En el campo Title, ingresa Moby Dick.
3. En el campo Author, ingresa Herman Melville.

4. Haz clic en Save. Ya tienes una entrada en la aplicación Bookshelf.

   
5. En la consola de Cloud de Confiance , haz clic en Actualizar refresh para actualizar la página de Firestore. Los datos aparecen en Firestore. La aplicación Bookshelf almacena cada libro como un documento de Firestore con un ID único, y todos estos documentos se almacenan en una colección de Firestore. Para los propósitos de este instructivo, la colección se llama “books”.

Firestore almacena los libros mediante la biblioteca cliente de Firestore. Aquí hay un ejemplo de recuperación de un documento de 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
}

Para obtener más información sobre el uso de Firestore, consulta cómo agregar datos a Firestore.

Almacena archivos subidos en Cloud Storage

Ahora que agregaste un libro, es momento de agregar su imagen de portada. No puedes almacenar archivos en tus instancias. Una base de datos no es la opción correcta para archivos de imagen. En cambio, debes usar Cloud Storage.

Cloud Storage es el almacenamiento de BLOB principal de Cloud de Confiance. Puedes usar Cloud Storage para alojar los recursos de la app que quieras compartir en Cloud de Confiance. Para usar Cloud Storage, debes crear un bucket de Cloud Storage, un contenedor básico en el que se guardan tus datos.

1. En la Cloud de Confiance consola, ve a la página Navegador de Cloud Storage.

   Ir a la página Navegador de Cloud Storage

2. Haz clic en Crear bucket.
3. En el cuadro de diálogo Crear bucket, adjunta el ID del proyecto Cloud de Confiance a la cadena _bucket para ingresar un nombre del bucket, de manera que sea similar a YOUR_PROJECT_ID_bucket. Este nombre está sujeto a los requisitos de nombres de los buckets. En el resto de los campos, se pueden conservar los valores predeterminados.
4. Haz clic en Crear.
5. Una vez que se haya creado el bucket, debe permitirse el acceso público a los objetos para que puedan consultarlos los usuarios. Si quieres permitir el acceso público a tus objetos, consulta el artículo Haz públicos los datos.
6. Haz clic en Edit book y selecciona una imagen para subirla como la portada del libro. Por ejemplo, puedes usar esta imagen de dominio público:
   
7. Haz clic en Save. Se te redireccionará a la página principal, en la que encontrarás una entrada a la app de Bookshelf.
   

La app de Bookshelf envía los archivos subidos a Cloud Storage a través de la biblioteca cliente de Cloud Storage.

// 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
}

Para obtener más información sobre cómo usar Cloud Storage, consulta la introducción a Cloud Storage.

Supervisa tu app con Google Cloud Observability

Ya implementaste la app y creaste y modificaste libros. A fin de supervisar estos eventos para los usuarios, usa la administración del rendimiento de las aplicaciones.

Supervisa los registros con Cloud Logging

1. En Cloud de Confiance, ve al Explorador de registros.

   Ir al Explorador de registros

   Puedes supervisar tu app en tiempo real. Si tienes problemas con tu app, este es uno de los primeros lugares que consultar.

   
2. En la lista desplegable Recursos, selecciona Revisión de Cloud Run, bookshelf.

Controla los errores con Error Reporting

1. En la consola de Cloud de Confiance , ve a la página Error Reporting.
   Ir a la página de Error Reporting
   Error Reporting destaca los errores y las excepciones en tu app y te permite configurar alertas basadas en ellos.
2. En el navegador, ve a la URL /errors de la app.
   

   YOUR_CLOUD_RUN_URL/errors

   Esto genera una nueva excepción de prueba y la envía a Google Cloud Observability.

3. En la consola de Cloud de Confiance , regresa a la página de Error Reporting y podrás ver el error nuevo en unos instantes. Haz clic en Volver a cargar automáticamente para no tener que actualizar la página de forma manual.