Muitas apps precisam de fazer processamento em segundo plano fora do contexto de um pedido Web. Este tutorial cria uma app Web que permite aos utilizadores introduzir texto para traduzir e, em seguida, apresenta uma lista de traduções anteriores. A tradução é feita num processo em segundo plano para evitar o bloqueio do pedido do utilizador.
O diagrama seguinte ilustra o processo de pedido de tradução.
Veja a sequência de eventos que explica como funciona a app de tutoriais:
- Visite a página Web para ver uma lista de traduções anteriores, armazenadas no Firestore.
- Peça uma tradução de texto introduzindo um formulário HTML.
- O pedido de tradução é publicado no Pub/Sub.
- É acionada uma função do Cloud Run subscrita nesse tópico do Pub/Sub.
- A função do Cloud Run usa o Cloud Translation para traduzir o texto.
- A função do Cloud Run armazena o resultado no Firestore.
Este tutorial destina-se a qualquer pessoa interessada em saber mais sobre o processamento em segundo plano com o Google Cloud. Não é necessária experiência prévia com as funções do Pub/Sub, Firestore, App Engine ou Cloud Run. No entanto, para compreender todo o código, é útil ter alguma experiência com Go, JavaScript e HTML.
Objetivos
- Compreender e implementar uma função do Cloud Run.
- Compreenda e implemente uma app do App Engine.
- Experimente a app.
Custos
Neste documento, usa os seguintes componentes faturáveis do Google Cloud:
Para gerar uma estimativa de custos com base na sua utilização projetada,
use a calculadora de preços.
Quando terminar as tarefas descritas neste documento, pode evitar a faturação contínua eliminando os recursos que criou. Para mais informações, consulte o artigo Limpe.
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.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Firestore, Cloud Run functions, Pub/Sub, and Cloud Translation APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles. -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Firestore, Cloud Run functions, Pub/Sub, and Cloud Translation APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles. -
Na Google Cloud consola, abra a app no Cloud Shell.
O Cloud Shell dá acesso à linha de comandos aos recursos da nuvem diretamente a partir do navegador. Abra o Cloud Shell no navegador e clique em Continuar para transferir o código de exemplo e mudar para o diretório da app.
-
No Cloud Shell, configure a ferramenta
gcloudpara usar o seu projeto Google Cloud :# Configure gcloud for your project gcloud config set project YOUR_PROJECT_ID
Compreender a função do Cloud Run
- A função começa por importar várias dependências, como o Firestore e a tradução. Também tem algumas variáveis e tipos globais.
- Os clientes globais do Firestore e do Translation são inicializados para que possam ser reutilizados entre invocações de funções. Desta forma, não tem de inicializar novos clientes para cada invocação de função, o que atrasaria a execução.
- A API Translation traduz a string para o idioma que selecionou.
-
A função do Cloud Run começa por inicializar os clientes do Firestore e do Pub/Sub. Em seguida, analisa a mensagem do Pub/Sub para obter o texto a traduzir e o idioma de destino pretendido.
Em seguida, a app apresenta um nome exclusivo para o pedido de tradução para garantir que não armazena traduções duplicadas. Em seguida, traduz numa transação do Firestore para garantir que as execuções simultâneas não executam acidentalmente a mesma tradução duas vezes.
Implementar a função do Cloud Run
No Cloud Shell, no mesmo diretório que o ficheiro
translate.go, implemente a função do Cloud Run com um acionador do Pub/Sub:gcloud functions deploy Translate --runtime go111 \ --trigger-topic=translate --set-env-vars GOOGLE_CLOUD_PROJECT=YOUR_GOOGLE_CLOUD_PROJECT
onde
YOUR_GOOGLE_CLOUD_PROJECTé o ID do seu Google Cloud projeto.
Compreender a app
Existem dois componentes principais para a app Web:
-
Um servidor HTTP Go para processar pedidos Web. O servidor tem os seguintes dois
pontos finais:
-
/: lista todas as traduções existentes e mostra um formulário que os utilizadores podem enviar para pedir novas traduções. -
/request-translation: os envios de formulários são enviados para este ponto final, que publica o pedido no Pub/Sub para ser traduzido de forma assíncrona.
-
- Um modelo HTML preenchido com as traduções existentes pelo servidor Go.
O servidor HTTP
No diretório
index, omain.gocomeça por configurar a app e registar controladores HTTP:O controlador de índice (
/) obtém todas as traduções existentes do Firestore e preenche um modelo HTML com a lista:As novas traduções são pedidas através do envio de um formulário HTML. O controlador de tradução de pedidos, registado em
/request-translation, analisa o envio do formulário, valida o pedido e publica uma mensagem no Pub/Sub:
O modelo HTML
O modelo HTML é a base da página HTML apresentada ao utilizador para que possa ver traduções anteriores e pedir novas. O modelo é preenchido pelo servidor HTTP com a lista de traduções existentes.
-
O elemento
<head>do modelo HTML inclui metadados, folhas de estilos e JavaScript para a página:A página extrai recursos de CSS e JavaScript do Material Design Lite (MDL). O MDL permite-lhe adicionar um aspeto do Material Design aos seus Websites.
A página usa JQuery para aguardar a conclusão do carregamento do documento e definir um controlador de envio de formulários. Sempre que o formulário de tradução de pedidos é enviado, a página faz uma validação mínima do formulário para verificar se o valor não está vazio e, em seguida, envia um pedido assíncrono para o ponto final
/request-translation.Por último, é apresentada uma barra de mensagens do MDL para indicar se o pedido foi bem-sucedido ou se ocorreu um erro.
- O corpo HTML da página usa um esquema MDL e vários componentes MDL para apresentar uma lista de traduções e um formulário para pedir traduções adicionais:
Criar a app
-
Antes de tentar implementar a app Web, crie a app para se certificar de que é compilada
e que todas as dependências estão a funcionar.
go build -o start ./indexA compilação foi bem-sucedida se não tiver sido impresso nada e tiver sido criado um ficheiro
start.
Implementar a app Web
Pode usar o ambiente padrão do App Engine para criar e implementar uma app que é executada de forma fiável sob carga elevada e com grandes quantidades de dados.
Este tutorial usa o ambiente padrão do App Engine para implementar o front-end HTTP.
O app.yaml configura a app do App Engine:
-
No mesmo diretório que o ficheiro
app.yaml, implemente a sua app no ambiente padrão do App Engine:gcloud app deploy
Testar a app
Depois de implementar a função do Cloud Run e a app do App Engine, experimente pedir uma tradução.
-
Para ver a app no navegador,introduza o seguinte URL:
https://PROJECT_ID.REGION_ID.r.appspot.comSubstitua o seguinte:
PROJECT_ID: o ID do seu Google Cloud projetoREGION_ID: um código que o App Engine atribui à sua app
Existe uma página com uma lista vazia de traduções e um formulário para pedir novas traduções.
-
No campo Texto a traduzir, introduza algum texto para traduzir, por exemplo,
Hello, World. - Selecione um idioma na lista pendente para o qual quer traduzir o texto.
- Clique em Enviar.
- Para atualizar a página, clique em Atualizar refresh. É apresentada uma nova linha na lista de traduções. Se não vir uma tradução, aguarde mais alguns segundos e tente novamente. Se ainda não vir uma tradução, consulte a secção seguinte sobre a depuração da app.
Depurar a app
Se não conseguir estabelecer ligação à sua app do App Engine ou não vir novas traduções, verifique o seguinte:
-
Verifique se os comandos de implementação
gcloudforam concluídos com êxito e não apresentaram erros. Se existirem erros, corrija-os e tente implementar a função do Cloud Run e a app do App Engine novamente. -
Na Google Cloud consola, aceda à página do visualizador de registos.
Aceda à página do visualizador de registos- Na lista pendente Recursos selecionados recentemente, clique em Aplicação GAE e, de seguida, clique em Todos os module_id. É apresentada uma lista de pedidos de quando visitou a sua app. Se não vir uma lista de pedidos, confirme que selecionou Todos os module_id na lista pendente. Se vir mensagens de erro impressas na Google Cloud consola, verifique se o código da sua app corresponde ao código na secção sobre a compreensão da app.
-
Na lista pendente Recursos selecionados recentemente, clique em
Função da nuvem e, de seguida, clique em Nome de todas as funções. É apresentada uma função para cada tradução pedida. Caso contrário, verifique se a função do Cloud Run e a app App Engine estão a usar o mesmo tópico do Pub/Sub:
- No ficheiro
background/index/main.go, verifique se a constantetopicNameé"translate". - Quando implementar a função do Cloud Run, certifique-se de que inclui a flag
--trigger-topic=translate.
- No ficheiro
Limpar
Para evitar incorrer em custos na sua conta do Google Cloud pelos recursos usados neste tutorial, elimine o projeto que contém os recursos ou mantenha o projeto e elimine os recursos individuais.
Elimine o Google Cloud 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.
Elimine a instância do App Engine
- In the Google Cloud console, go to the Versions page for App Engine.
- Select the checkbox for the non-default app version that you want to delete.
- Para eliminar a versão da app, clique em Eliminar.
Elimine a função do Cloud Run
-
Elimine a função do Cloud Run que criou neste tutorial:
gcloud functions delete Translate
O que se segue?
- Experimente tutoriais de funções do Cloud Run adicionais.
- Saiba mais sobre o App Engine.
- Experimente o Cloud Run, que lhe permite executar contentores sem estado num ambiente totalmente gerido ou no seu próprio cluster do Google Kubernetes Engine.