Começar a usar Go

---

Este tutorial destina-se a quem está começando a criar apps na nuvem, como engenheiros e desenvolvedores da Web que querem aprender os conceitos-chave de desenvolvimento de apps no que se referem ao Google Cloud.

Objetivos

• Conhecer ferramentas básicas do Google Cloud, como o Console do Google Cloud e o gcloud.
• Implantar seu app no Cloud Run.
• Manter seus dados no Firestore.
• Armazenar uploads de arquivos no Cloud Storage.
• Monitore seu app usando a Observabilidade do Google Cloud.

Custos

Neste documento, você usará os seguintes componentes faturáveis do Google Cloud:

• Cloud Run
• Artifact Registry
• Cloud Build
• Cloud Storage
• Firestore
• Google Cloud Observability

As instruções neste documento foram criadas para manter seu uso de recursos dentro dos limites do Sempre gratuito do Google Cloud. camada. Para gerar uma estimativa de custo baseada na projeção de uso deste tutorial, use a calculadora de preços. Novos usuários do Google Cloud podem estar qualificados para uma avaliação gratuita.

Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Saiba mais em Limpeza.

Antes de começar

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

4. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

5. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

6. Para criar um banco de dados do Firestore no modo nativo, conclua as seguintes etapas:
   1. No console do Google Cloud, acesse a página Criar banco de dados do Firestore.
      

      Acessar o banco de dados de criação do Firestore

   2. Na tela Selecione um modo do Cloud Firestore, clique em Selecionar Modo nativo.
   3. Selecione um local para seu banco de dados do Firestore. Essa configuração refere-se ao local padrão de recurso do Google Cloud para seu projeto do Google Cloud. Esse local é usado para serviços do Google Cloud no projeto do Google Cloud que exigem uma configuração de local, especificamente o bucket padrão do Cloud Storage e o app Cloud Run.
      Aviso: depois de definir o local de recurso padrão para seu projeto do Google Cloud, não será possível alterá-lo.
   4. Clique em Criar banco de dados.

7. Ative as APIs Artifact Registry, Cloud Run Admin, Cloud Build, Cloud Storage, Cloud Logging, and Error Reporting.

   Ative as APIs

8. Clone o repositório de amostra e abra o aplicativo de amostra no Cloud Shell:
   Acessar o Cloud Shell

   O Cloud Shell oferece acesso de linha de comando aos seus recursos do Google Cloud diretamente no navegador.

9. Para fazer o download do código de exemplo e passar para o diretório do app, clique em Continuar.

10. No Cloud Shell, configure a ferramenta gcloud para usar seu novo projeto do Google Cloud:

    # Configure gcloud for your project
    gcloud config set project PROJECT_ID
    

    Substitua PROJECT_ID pelo ID do projeto do Google Cloud que você criou usando o console do Google Cloud.

    A Google Cloud CLI é a principal maneira de interagir com seus recursos do Google Cloud pela linha de comando. Neste tutorial, você usará a ferramenta gcloud para implantar e monitorar seu app.

Executar o app

1. Crie o app, que faz o download das dependências automaticamente:

   go build
   

2. Execute o app:

   GOOGLE_CLOUD_PROJECT=PROJECT_ID ./bookshelf
   

   Substitua PROJECT_ID pelo ID do projeto do Google Cloud que você criou.
3. No Cloud Shell, clique em Visualização da Web e selecione Visualizar na porta 8080. Uma nova janela será aberta com o app em execução.

Como implantar o app no Cloud Run

O Google Cloud oferece várias opções de execução do código. Neste exemplo, você usa o Cloud Run para implantar um app escalonável no Google Cloud. 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 .

   Seu app agora está visível 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.
   Observação: este domínio protegido por SSL é criado automaticamente e é útil para o desenvolvimento. É possível também configurar um domínio personalizado com o Cloud Run.

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

Manter seus dados com o 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.

O Google Cloud 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 aplicativo 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 do Google Cloud, para atualizar a página do Firestore, clique em Atualizar . 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 Cloud 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 Google Cloud. Use o Cloud Storage para hospedar recursos de app que você quer compartilhar em todo o Google Cloud. 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 do Cloud, 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 do Google Cloud à string _bucket, de modo que o nome fique assim: YOUR_PROJECT_ID_bucket. Este 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 (em inglês).

// 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 o uso do Cloud Storage, consulte Introdução ao Cloud Storage.

Monitorar seu app usando a observabilidade do Google Cloud

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 Google Cloud, acesse a Análise 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 do Google Cloud, 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 para a observabilidade do Google Cloud.

3. No console do Google Cloud, retorne à página Error Reporting e, em alguns instantes, o novo erro estará visível. Clique em Recarregar automaticamente para não precisar atualizar manualmente a página.

   

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados no tutorial, exclua o projeto que os contém ou mantenha o projeto e exclua os recursos individuais.

Exclua o projeto

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

1. No Console do Google Cloud, acesse a página Gerenciar recursos.

   Acessar "Gerenciar recursos"

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

A seguir

• Como implantar um app no Google Kubernetes Engine
• Como implantar um aplicativo no Compute Engine
• Como gerenciar sessões com o Firestore