Os pools de workers processam cargas de trabalho sem solicitação. Para casos de uso que precisam dividir o trabalho entre várias revisões, como a implantação de uma nova revisão, os pools de workers usam divisão de instâncias.
O Cloud Run permite especificar quais revisões recebem instâncias e especificar porcentagens de alocação de instâncias para cada revisão. Com esse recurso, é possível reverter para uma revisão anterior, dividir instâncias entre várias revisões e alocar instâncias para a revisão mais recente. Nesta página, descrevemos como usar esse recurso para gerenciar a alocação de instâncias nas suas revisões do Cloud Run.
Os ajustes na alocação de instâncias não são instantâneos. Quando você muda a alocação de instâncias para revisões, todas as solicitações em processamento continuam até a conclusão. As solicitações em andamento não são descartadas, e o Cloud Run pode direcionar essas solicitações para uma revisão nova ou anterior durante o período de transição.
Ciclo de vida das divisões de instâncias
Se você dividir instâncias entre várias revisões ou atribuir instâncias a uma revisão anterior, todas as implantações subsequentes usarão esse padrão de divisão de instâncias daí em diante. Para voltar a usar apenas a revisão mais recente sem divisão de instâncias, envie todas as instâncias para a revisão mais recente.
Funções exigidas
Para ter as permissões necessárias para gerenciar pools de trabalhadores e revisões de pool de trabalhadores do Cloud Run,
peça ao administrador para conceder a você o
papel do IAM de Desenvolvedor do Cloud Run (roles/run.developer)
no pool de trabalhadores do Cloud Run.
Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o pool de trabalhadores do Cloud Run interagir com APIsGoogle Cloud , como as bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.
Reverter para uma revisão anterior
Para reverter para uma revisão anterior, use o console Google Cloud ou a Google Cloud CLI:
Console
No console do Google Cloud , acesse os pools de trabalhadores do Cloud Run:
Localize o pool de worker na lista e clique nele.
Clique na guia Revisões para mostrar a lista de revisões atuais desse pool de trabalhadores.
Clique em Gerenciar divisões de instâncias para mostrar o formulário de gerenciamento de instâncias. O Cloud Run lista a revisão de serviço mais recente. No formulário, configure os seguintes detalhes:
- Clique em Adicionar revisão e use a lista suspensa para selecionar uma revisão anterior.
- Defina a porcentagem de instâncias da revisão anterior como 100.
- Defina a porcentagem da revisão de exibição mais recente como 0.
- Clique em Salvar.
gcloud
Especifique as revisões para as quais fazer o rollback executando o seguinte comando.
gcloud beta run worker-pools update-instance-split WORKER_POOL --to-revisions=REVISION=100
Substitua:
- WORKER_POOL: o nome do pool de workers.
- REVISION: o nome da revisão para a qual você está revertendo.
Dividir instâncias entre várias revisões
Para dividir instâncias entre duas ou mais revisões, use o console Google Cloud ou a Google Cloud CLI:
Ao dividir instâncias entre várias revisões, verifique se a porcentagem total em todas as revisões é igual a 100% e se o número de instâncias manuais é maior que o número de divisões de instâncias que atendem à carga de trabalho.
Console
No console do Google Cloud , acesse os pools de trabalhadores do Cloud Run:
Localize o pool de worker na lista e clique nele.
Clique na guia Revisões para mostrar a lista de revisões atuais desse pool de worker.
Clique em Gerenciar divisões de instâncias para mostrar o formulário de gerenciamento de instâncias. O Cloud Run lista a revisão de serviço mais recente. No formulário, configure os seguintes detalhes:
Defina a porcentagem da revisão de exibição mais recente para a divisão necessária, por exemplo, reduza de 100%.
Clique em Adicionar revisão e use a lista suspensa para selecionar uma revisão anterior e definir a porcentagem correspondente.
Para dividir instâncias com mais revisões, clique em Adicionar revisão, selecione outra revisão e defina a porcentagem dela.
Clique em Salvar.
gcloud
Especifique as revisões e a porcentagem de instâncias executando o seguinte comando. Alocar instâncias para cada revisão em uma lista delimitada por vírgulas:
gcloud beta run worker-pools update-instance-split WORKER_POOL --to-revisions=LIST
Substitua:
WORKER_POOL: o nome do pool de workers.
LIST: lista delimitada por vírgulas de revisões e porcentagens:
REVISION1=PERCENTAGE1,REVISION2=PERCENTAGE2,REVISIONn=PERCENTAGEx.
Por exemplo,
my-worker-pool-s5sxn=10,my-worker-pool-cp9kw=90
Alocar instâncias para a revisão mais recente
Ao implantar uma nova revisão, é possível alocar 100% das instâncias para essa revisão e todas as futuras, modificando qualquer divisão de instâncias estabelecida. Para alocar 100% das instâncias à revisão mais recente, execute os seguintes comandos:
Use a flag
--to-latestpara direcionar 100% das instâncias à revisão mais recente e alocar automaticamente todas as instâncias a qualquer nova revisão implantada:gcloud beta run worker-pools update-instance-split WORKER_POOL --to-latestOpcionalmente, use a flag
--to-revisionscom a palavra-chaveLATESTpara sempre alocar uma porcentagem flutuante de instâncias à revisão mais recente ao implantar uma. Para definir uma porcentagem de instâncias que sempre flutuam para a revisão mais recente, execute o seguinte comando:gcloud beta run worker-pools update-instance-split WORKER_POOL --to-revisions=LATEST=PERCENTAGESubstitua:
- WORKER_POOL: o nome do pool de workers.
- PERCENTAGE: a porcentagem de instâncias a serem alocadas para as revisões mais recentes e futuras.