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 de faturamento baseado em instância para ter a CPU alocada fora do ciclo de solicitação padrão.
  • Se o serviço usa o NFS, 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 deles disponibilizado por imagens de base de contêiner fornecidas pelos buildpacks do Google Cloud. Também é possível usar outras linguagens ou frameworks de programação, 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 maneira ideal. Com o Gemini Cloud Assist, é possível 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 Google Cloud console, faça o seguinte:

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

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

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

    Acessar o Cloud Run

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

  5. Clique em brilho Abrir ou fechar o chat da IA do Gemini.

    O painel do Gemini será aberto.

  6. Se necessário, clique em Aceitar se 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 seu recurso antes de fazer a pergunta. Ao gerar uma resposta, o Gemini inclui informações sobre a página e o projeto do console atual.

  8. Insira um comando no painel 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 preciso saber? Resumo da contentorização do app, da estruturação do app Node.js e do processo de implantação.
    "De qual permissão preciso para implantar um app do Cloud Run?" Lista de permissões e papéis necessários.
    "Quero implantar um aplicativo da Web de três níveis usando o Cloud Run" Esboço geral das etapas para projetar um app da Web de três níveis.
    "Como migro meu app do App Engine para o Cloud Run" Visão geral das principais etapas para preparar o 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 atualizo minha conta de serviço para meu serviço do Cloud Run hello-world" Comando sugerido da CLI 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.
    "Gere uma configuração do Terraform usando o recurso google_cloud_run_v2_service para um serviço do Cloud Run que define a configuração de faturamento como faturamento baseado em instância" Configuração sugerida do Terraform para atualizar a configuração de faturamento.

Para saber mais, acesse os recursos a seguir:

A seguir