Primeiros passos com o Go

Como implantar o app no Cloud Run

OCloud de Confiance oferece várias opções para executar seu código. Neste exemplo, você usa o Cloud Run para implantar um app escalonável em Cloud de Confiance. O Cloud Run não exige que você gerencie servidores e é escalonado automaticamente para suportar picos de tráfego.

1. Execute o contêiner com o Cloud Run:

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

   Agora, é possível visualizar o aplicativo no URL exibido na saída 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 no seu navegador da Web para visualizar o aplicativo.

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

Manter seus dados no Firestore

Não é possível armazenar informações nas suas instâncias do Cloud Run porque elas serão perdidas se a instância for reiniciada e deixarão de existir quando novas instâncias forem criadas. No entanto, é possível usar um banco de dados no qual todas as suas instâncias possam ler e gravar dados.

OCloud de Confiance oferece várias opções para armazenar seus dados. Neste exemplo, você usa o Firestore para armazenar os dados de cada livro. O Firestore é um banco de dados de documentos NoSQL totalmente gerenciado e sem servidor, que permite armazenar e consultar dados. Ele é escalonado automaticamente para atender às necessidades do app, sendo reduzido a zero quando não estiver sendo usado. Adicione seu primeiro livro agora.

1. Para criar um livro para seu app implantado, clique em Adicionar livro.

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

4. Clique em Salvar. Agora há uma entrada em seu app Bookshelf.

   
5. No console Cloud de Confiance , para atualizar a página do Firestore, clique em Atualizar refresh. Os dados são exibidos no Firestore. O app Bookshelf armazena cada livro como um documento do Firestore com um ID exclusivo. Todos esses documentos são armazenados em uma coleção do Firestore. Para os fins deste tutorial, a coleção é chamada de books.

O Firestore armazena os livros usando a biblioteca de cliente do Firestore (em inglês). Veja a seguir um exemplo de como buscar 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 como usar o Firestore, consulte Como adicionar dados ao Firestore.

Armazenar uploads de arquivos no Cloud Storage

Agora que você adicionou um livro, é hora de adicionar a imagem da capa. Não é possível armazenar arquivos em suas instâncias. Um banco de dados não é a opção correta para arquivos de imagem. Em vez disso, use o Cloud Storage.

O Cloud Storage é o principal repositório de blobs do Cloud de Confiance. Use o Cloud Storage para hospedar recursos de app que você quer compartilhar em Cloud de Confiance. Para usar o Cloud Storage, você precisa criar um bucket do Cloud Storage, um contêiner básico para guardar seus dados.

1. No console Cloud de Confiance , acesse a página Navegador do Cloud Storage.

   Acessar a página "Navegador do Cloud Storage"

2. Clique em Criar bucket.
3. Na caixa de diálogo Criar bucket, insira um nome para ele, anexando o ID do projeto Cloud de Confiance à string _bucket para que o nome fique assim: YOUR_PROJECT_ID_bucket. Esse nome está sujeito aos requisitos de nome de bucket. Todos os demais campos permanecem nos valores padrão.
4. Clique em Criar.
5. Após a criação do bucket, libere o acesso público aos objetos para que os usuários consigam vê-los. Para saber como fazer isso, consulte Como tornar os dados públicos.
6. Clique em Editar livroe selecione uma imagem para carregar como a capa. Por exemplo, é possível usar este arquivo de domínio público:
   
7. Clique em Salvar. Você será redirecionado para a página inicial onde há uma entrada do seu app Bookshelf.
   

O app Bookshelf envia os arquivos carregados para o Cloud Storage usando a biblioteca de 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 como usar o Cloud Storage, consulte a introdução ao Cloud Storage.

Monitore seu app usando o Google Cloud Observability

Você implantou seu app, depois criou e modificou livros. Para monitorar esses eventos para seus usuários, use o Gerenciamento do desempenho de aplicativos.

Monitore registros com o Cloud Logging

1. No Cloud de Confiance, acesse o Explorador de registros

   Acessar o Explorador de registros

   É possível monitorar seu app em tempo real. Se encontrar problemas em seu app, este é o primeiro lugar a ser verificado.

   
2. Na lista suspensa Recurso, selecione Revisão do Cloud Run, bookshelf.

Monitore erros com o Error Reporting

1. No console Cloud de Confiance , acesse a página Error Reporting.
   Acessar a página Error Reporting
   O Error Reporting destaca os erros e as exceções em seu app, além de permitir que você configure alertas para eles.
2. No navegador, acesse o URL /errors em seu app.
   

   YOUR_CLOUD_RUN_URL/errors

   Isso gera uma nova exceção de teste e a envia ao Google Cloud Observability.

3. No console Cloud de Confiance , volte para a página Error Reporting e aguarde alguns instantes para ver o novo erro. Clique em Atualizar automaticamente para não precisar atualizar manualmente a página.