Como desenvolver seu serviço

Nesta página, descrevemos alguns itens que você precisa conhecer para começar a desenvolver um serviço para o Cloud Run.

Exigências de código

Atenda aos requisitos a seguir ao desenvolver um serviço:

  • O serviço precisa detectar solicitações. É possível configurar a porta em que as solicitações são enviadas. Dentro das instâncias de contêiner do Cloud Run, o valor da variável de ambiente PORT sempre reflete a porta para a qual as solicitações são enviadas. O código precisa verificar a existência da variável de ambiente PORT e, se ela estiver presente, detectá-la para maximizar a portabilidade.
  • O serviço precisa ser do tipo sem estado. Ele não pode depender de um estado local permanente.
  • Se o serviço executa atividades em segundo plano fora do escopo do processamento de solicitações, ele precisa usar a configuração Faturamento baseado em instância para ter a CPU alocada fora do ciclo de solicitação padrão.
  • Se o serviço usa um sistema de arquivos de rede, ele precisa utilizar o ambiente de execução da segunda geração.

Confira mais detalhes sobre essas restrições no Contrato do ambiente de execução do contêiner.

Compatibilidade com linguagens de programação

A implantação de origem do Cloud Run oferece suporte a vários ambientes de execução de linguagem, cada um disponível por imagens de base de contêiner fornecidas pelos buildpacks do Google Cloud. Você também pode usar outras linguagens de programação ou frameworks, desde que o código-fonte esteja em uma imagem compatível com o OCI.

Os guias de início rápido de criação e implantação fornecem amostras em muitas linguagens conhecidas.

Como usar um servidor da Web

Use um servidor da Web para realizar detecções na porta necessária, bem como para processar e rotear solicitações recebidas. Por exemplo, os desenvolvedores do Node.js podem usar o Express.js, os desenvolvedores do Python podem usar o Flask, os desenvolvedores do Ruby podem usar o Sinatra, e assim por diante.

Como contentorizar seu código

Consulte Conteinerizar seu código para mais detalhes.

Projetar apps do Cloud Run com a ajuda do Gemini

Você pode receber ajuda com tecnologia de IA do chat do Gemini Cloud Assist para projetar aplicativos de forma otimizada. Com o Gemini Cloud Assist, você pode descobrir as configurações e estratégias mais adequadas para implantar seus aplicativos no Cloud Run, garantindo a utilização eficiente de recursos e a operação perfeita.

Para usar o Gemini Cloud Assist no console do Google Cloud, faça o seguinte:

  1. Verifique se o Gemini Cloud Assist está configurado para seu Google Cloud projeto e conta de usuário.

  2. Configure seu ambiente de desenvolvimento do Cloud Run no projeto Google Cloud e verifique se você tem as permissões de implantação adequadas.

  3. Acesse a página do Cloud Run no Console do Google Cloud.

    Acessar o Cloud Run

  4. Na barra de ferramentas do console, selecione um projeto Google Cloud . Use um projeto associado a um ID de projeto que você enviou depois de receber acesso ao Gemini Cloud Assist.

  5. Clique em spark Abrir ou fechar o chat da Gemini AI.

    O painel Gemini será aberto.

  6. Se necessário, clique em Aceitar se você concordar com os termos.

  7. Se você tiver uma dúvida sobre um aplicativo específico, forneça contexto acessando a página que mostra o recurso antes de fazer a pergunta. Ao gerar uma resposta, o Gemini inclui informações sobre a página e o projeto atuais do console.

  8. Insira um comando no painel do Gemini.

    A tabela a seguir fornece alguns exemplos de comandos para usar o Gemini Cloud Assist com o Cloud Run.

    Comando Tipo de resposta
    "Quero projetar um app Node.js no Cloud Run. Qual é a abordagem recomendada e o que eu preciso saber?" Resumo sobre como contêinerizar seu app, estruturar seu app Node.js e o processo de implantação.
    "What permission do I need to deploy a Cloud Run app?" Lista de permissões e papéis obrigatórios.
    "Quero implantar um aplicativo da Web de três níveis usando o Cloud Run" Descrição geral das etapas para projetar um app da Web de três camadas.
    "Como migrar meu app do App Engine para o Cloud Run" Visão geral de alto nível das principais etapas para preparar seu ambiente de desenvolvimento do Cloud Run e algumas diferenças importantes entre os dois produtos. Links para um tutorial de exemplo que pode ser usado para personalizar a solução de acordo com suas necessidades específicas.
    "Qual é o comando da CLI gcloud para atualizar a configuração de instância mínima para 2 no meu serviço do Cloud Run 'example-service'" Comando sugerido da CLI gcloud para atualizar a configuração de instâncias mínimas.
    "Como atualizar minha conta de serviço para o serviço do Cloud Run hello-world" Comando sugerido da CLI do gcloud para atualizar a conta de serviço.
    "Mostre um exemplo de como criar um app de IA generativa no Cloud Run com o LangChain" Etapas para criar um app de exemplo usando o Cloud Run com o LangChain.
    "Generate a config Terraform using the google_cloud_run_v2_service resource for a Cloud Run service that sets the billing setting to instance-based billing" Sugestão de configuração do Terraform para atualizar a configuração de faturamento.

Para saber mais, acesse os recursos a seguir:

A seguir