Neste tutorial, você aprenderá como começar a usar o Compute Engine. Para segui-lo, implante um app Go da Web "Hello World" no Compute Engine. Para receber ajuda com os primeiros passos no App Engine, consulte o ambiente padrão do App Engine.
Objetivos
- Usar o Cloud Shell para fazer o download e implantar um app de amostra "Hello World".
- Use o Cloud Build para criar um app de amostra "Hello World".
- Implantar um app de amostra "Hello World" em uma única instância do Compute Engine.
Custos
Neste documento, você usará os seguintes componentes faturáveis do Google Cloud:
Para gerar uma estimativa de custo baseada na projeção de uso deste tutorial, use a calculadora de preços.
Antes de começar
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Compute Engine and Cloud Build APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Compute Engine and Cloud Build APIs.
-
No console do Google Cloud, abra o app no Cloud Shell.
O Cloud Shell oferece acesso por linha de comando aos seus recursos de nuvem diretamente no navegador.
-
Se você concordar em clonar o repositório, clique em Confirmar para fazer o download do exemplo de código e mudar para o app diretório.
-
No Cloud Shell, configure a CLI gcloud para usar seu novo projeto do Google Cloud:
# Configure gcloud for your project gcloud config set project YOUR_PROJECT_ID
Como executar o app no Cloud Shell
No Cloud Shell, inicie um servidor da Web local:
go build -o app ./app
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.
No navegador, você vê
Hello, World!
.Quando estiver pronto para prosseguir, pare o servidor da Web local pressionando Control+C no Cloud Shell.
Implantar em uma instância única
Veja nesta seção como executar uma única instância do aplicativo no Compute Engine.
No Cloud Shell, é possível implantar em uma máquina virtual (VM, na sigla em inglês) de instância única do Compute Engine que executa o aplicativo.
Usar o Cloud Build para criar o aplicativo
O Cloud Build é usado para criar o aplicativo, compactá-lo em um arquivo tar e fazer o upload dele em um bucket do Cloud Storage. buckets são os contêineres básicos que armazenam seus dados no Cloud Storage.
Na janela de terminal, crie um bucket do Cloud Storage, em que
YOUR_BUCKET_NAME
representa o nome do bucket:gcloud storage buckets create gs://YOUR_BUCKET_NAME
Você pode escolher qualquer nome para o bucket do Cloud Storage. Recomendamos dar ao bucket o mesmo nome do ID do projeto. Como os nomes de buckets precisam ser exclusivos em todo o Google Cloud, talvez você não consiga usar o ID do projeto como o nome do bucket.
Inicie o processo do Cloud Build:
gcloud builds submit --substitutions=_DEPLOY_DIR=gs://
YOUR_BUCKET_NAME
,_DEPLOY_FILENAME=app.tar.gzO comando
gcloud builds submit
usa--substitutions
para configurar o local em que o arquivo tar resultante é enviado. Posteriormente, o arquivo tar será salvo para a instância do Compute Engine.O Cloud Build usa um arquivo de configuração YAML para definir as etapas exigidas pela versão.
Usar um script para inicializar uma instância
É necessário instruir sua instância para que ela faça o download e execute o código. Isso pode ser feito por meio de um script de inicialização que é executado sempre que a instância for iniciada ou reiniciada.
Um script de inicialização é executado quando uma instância é inicializada pela primeira vez.
Estas tarefas são executadas no script de inicialização:
Instala o agente do Cloud Logging e o configura para monitorar os registros do aplicativo.
Faz o download e extrai o arquivo tar de implantação.
Inicia um serviço
systemd
para executar o aplicativo.
Criar e configurar uma instância do Compute Engine
Crie uma instância do Compute Engine:
Linux/macOS
gcloud compute instances create my-app-instance \ --image-family=debian-10 \ --image-project=debian-cloud \ --machine-type=g1-small \ --scopes userinfo-email,cloud-platform \ --metadata-from-file startup-script=startup-script.sh \ --metadata app-location="gs://YOUR_BUCKET_NAME/app.tar.gz" \ --zone YOUR_ZONE \ --tags http-server
Substitua
YOUR_ZONE
por uma zona de desenvolvimento. Por exemplo,us-central1-a
. Para mais informações sobre regiões e zonas, consulte Geografia e regiões.A sinalização
--metadata app-location
informa ao script de inicialização onde fazer o download do arquivo tar do aplicativo.Windows
gcloud compute instances create my-app-instance ^ --image-family=debian-10 ^ --image-project=debian-cloud ^ --machine-type=g1-small ^ --scopes userinfo-email,cloud-platform ^ --metadata-from-file startup-script=startup-script.sh ^ --metadata app-location="gs://YOUR_BUCKET_NAME/app.tar.gz" ^ --zone YOUR_ZONE ^ --tags http-server
Substitua
YOUR_ZONE
por uma zona de desenvolvimento. Por exemplo,us-central1-a
. Para mais informações sobre regiões e zonas, consulte Geografia e regiões.A sinalização
--metadata app-location
informa ao script de inicialização onde fazer o download do arquivo tar do aplicativo.Isso cria uma nova instância e permite que ela acesse os serviços do Google Cloud e execute o script de inicialização. O nome da instância é
my-app-instance
.Verifique o andamento da criação da instância:
gcloud compute instances get-serial-port-output my-app-instance --zone YOUR_ZONE
Quando o script de inicialização estiver concluído, você verá a seguinte mensagem:
startup-script: INFO Finished running startup scripts.
Crie uma regra de firewall para permitir o tráfego para a instância:
gcloud compute firewall-rules create default-allow-http-80 \ --allow tcp:80 \ --source-ranges 0.0.0.0/0 \ --target-tags http-server \ --description "Allow port 80 access to http-server"
Receba o endereço IP externo da instância:
gcloud compute instances list
Para ver a execução do aplicativo, insira este URL no navegador:
http://YOUR_INSTANCE_IP
Substitua
YOUR_INSTANCE_IP
pelo endereço IP externo da instância.
Gerenciar e monitorar uma instância
Use o console do Google Cloud para monitorar e gerenciar a instância.
- In the Google Cloud console, go to the VM instances page.
- In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.
- Para acessar todos os registros gerados pelos recursos do Compute Engine,
Acesse a página Análise de registros.
Acessar a Análise de registros
O Cloud Logging é configurado automaticamente para reunir registros de vários serviços comuns, incluindo o
syslog
.
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
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Excluir recursos individuais
gcloud compute instances delete my-app-instance --zone=YOUR_ZONE --delete-disks=all gcloud compute firewall-rules delete default-allow-http-80
A seguir
Confira arquiteturas de referência, diagramas, tutoriais e práticas recomendadas do Google Cloud. Confira o Centro de arquitetura do Cloud.
Para ver outros recursos do Go para criar apps, consulte:
- Gerencie e monitore a implantação do grupo de instâncias em Compute Engine > Grupos de instâncias.
- Gerencie sua configuração de balanceamento de carga, incluindo mapas de URL e serviços de back-end em Serviços de rede > Balanceamento de carga.
- Implantar um app no Google Kubernetes Engine
- Explore outros serviços do Google Cloud.