Os pools de workers processam cargas de trabalho que não são de 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 a divisão de instâncias.
O Cloud Run permite especificar quais revisões recebem instâncias e as porcentagens de alocação de instâncias para cada revisão. Esse recurso permite reverter para uma revisão anterior, dividir instâncias entre várias revisões e alocar instâncias para a revisão mais recente. Esta página descreve como usar esse recurso para gerenciar a alocação de instâncias para as revisões do Cloud Run.
Os ajustes de 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 nova revisão ou uma revisão 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. 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
Se quiser ter as permissões necessárias para gerenciar os pools de workers e as revisões do pool de workers 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 workers 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 workers do Cloud Run tiver interface com Google Cloud APIs, como as bibliotecas de cliente do Cloud, consulte o guia de configuração da identidade do 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 Google Cloud console ou a Google Cloud CLI:
Console
No Google Cloud console, acesse os pools de workers do Cloud Run:
Localize o pool de workers na lista e clique nele.
Clique na guia Revisões para mostrar a lista de revisões atuais desse pool de workers.
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:
- 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 serviço mais recente como 0.
- Clique em Salvar.
gcloud
Especifique as revisões para reverter executando o seguinte comando.
gcloud 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 Google Cloud console 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 deve ser maior que o número de divisões de instâncias que atendem à carga de trabalho.
Console
No Google Cloud console, acesse os pools de workers do Cloud Run:
Localize o pool de workers na lista e clique nele.
Clique na guia Revisões para mostrar a lista de revisões atuais desse pool de workers.
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 serviç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 divisão de porcentagem correspondente.
Para dividir instâncias com outras revisões, clique em Adicionar revisão, e 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 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, substituindo qualquer divisão de instâncias estabelecida. Para alocar 100% das instâncias para a revisão mais recente, execute os seguintes comandos:
Use a flag
--to-latestpara direcionar 100% das instâncias para a revisão mais recente e alocar automaticamente todas as instâncias para qualquer nova revisão que você implantar:gcloud 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 para a revisão mais recente quando você implantar uma. Para definir uma porcentagem de instâncias que sempre flutuam para a revisão mais recente, execute o seguinte comando:gcloud 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.