Comece a usar o Go

Implementar a sua app no Cloud Run

Cloud de Confiance oferece várias opções para executar o seu código. Para este exemplo, usa o Cloud Run para implementar uma app escalável no Cloud de Confiance. O Cloud Run não requer que faça a gestão de servidores e é dimensionado automaticamente para suportar picos de tráfego.

1. Execute o contentor com o Cloud Run:

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

   A sua app está agora visível no URL apresentado no 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. Copie o URL para o navegador de Internet para ver a app.

Para mais informações sobre a implementação no Cloud Run, consulte a documentação do Cloud Run.

Persista os seus dados com o Firestore

Não pode armazenar informações nas suas instâncias do Cloud Run, porque são perdidas se a instância for reiniciada e não existem quando são criadas novas instâncias. Em alternativa, usa uma base de dados a partir da qual todas as suas instâncias leem e na qual escrevem.

Cloud de Confiance oferece várias opções para armazenar os seus dados. Neste exemplo, usa o Firestore para armazenar os dados de cada livro. O Firestore é uma base de dados de documentos NoSQL totalmente gerida e sem servidor que lhe permite armazenar e consultar dados. O Firestore é automaticamente dimensionado para satisfazer as necessidades da sua app e é dimensionado para zero quando não o está a usar. Adicione o seu primeiro livro agora.

1. Para criar um livro para a sua app implementada, clique em Adicionar livro.

   
2. No campo Título, introduza Moby Dick.
3. No campo Autor, introduza Herman Melville.

4. Clique em Guardar. Agora, existe uma entrada para a app Bookshelf.

   
5. Na Cloud de Confiance consola, para atualizar a página do Firestore, clique em Atualizar refresh. Os dados são apresentados no Firestore. A app Bookshelf armazena cada livro como um documento do Firestore com um ID exclusivo, e todos estes documentos são armazenados numa coleção do Firestore. Para efeitos deste tutorial, a coleção chama-se books.

O Firestore armazena os livros através da biblioteca cliente do Firestore. Segue-se um exemplo de obtenção de um documento do 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 mais informações sobre a utilização do Firestore, consulte o artigo Adicionar dados ao Firestore.

Armazene carregamentos de ficheiros no Cloud Storage

Agora que adicionou um livro, está na altura de adicionar a imagem da capa do livro. Não pode armazenar ficheiros nas suas instâncias. Uma base de dados não é a escolha certa para ficheiros de imagem. Em alternativa, use o Cloud Storage.

O Cloud Storage é o armazenamento de objetos binários principal para o Cloud de Confiance. Pode usar o Cloud Storage para alojar recursos de apps que quer partilhar em várias plataformas Cloud de Confiance. Para usar o Cloud Storage, tem de criar um contentor do Cloud Storage, um contentor básico para armazenar os seus dados.

1. Na Cloud de Confiance consola, aceda à página Navegador do Cloud Storage.

   Aceda à página do navegador do armazenamento na nuvem

2. Clique em Criar contentor.
3. Na caixa de diálogo Criar contentor, introduza um nome para o contentor anexando o Cloud de Confiance ID do projeto à string _bucket para que o nome se assemelhe a YOUR_PROJECT_ID_bucket. Este nome está sujeito aos requisitos do nome do contentor. Todos os outros campos podem permanecer com os respetivos valores predefinidos.
4. Clique em Criar.
5. Depois de criar o contentor, os objetos têm de ser tornados acessíveis publicamente para serem vistos pelos utilizadores. Para tornar os seus objetos acessíveis publicamente, consulte o artigo Tornar os dados públicos.
6. Clique em Editar livro e selecione uma imagem para carregar como capa do livro. Por exemplo, pode usar esta imagem de domínio público:
   
7. Clique em Guardar. É feito o redirecionamento para a página inicial, onde existe uma entrada para a app Bookshelf.
   

A app de livros envia ficheiros carregados para o Cloud Storage através da biblioteca cliente do 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 mais informações sobre a utilização do Cloud Storage, consulte a introdução ao Cloud Storage.

Monitorize a sua app com a Google Cloud Observability

Implementou a sua app e criou e modificou livros. Para monitorizar estes eventos para os seus utilizadores, use a gestão do desempenho das aplicações.

Monitorize registos com o Cloud Logging

1. No Cloud de Confiance, aceda ao Explorador de registos

   Aceda ao Explorador de registos

   Pode monitorizar a sua app em tempo real. Se tiver problemas com a sua app, este é um dos primeiros locais a consultar.

   
2. Na lista pendente Recurso, selecione Revisão do Cloud Run, estante.

Monitorize erros com o Error Reporting

1. Na Cloud de Confiance consola, aceda à página Relatórios de erros.
   Aceda à página Relatório de erros
   O Relatório de erros realça erros e exceções na sua app e permite-lhe configurar alertas em torno dos mesmos.
2. No navegador, aceda ao /errorsURL na sua app.
   

   YOUR_CLOUD_RUN_URL/errors

   Isto gera uma nova exceção de teste e envia-a para o Google Cloud Observability.

3. Na Cloud de Confiance consola, regresse à página Relatório de erros e, dentro de alguns momentos, o novo erro fica visível. Clique em Atualizar automaticamente para não ter de atualizar a página manualmente.