Como definir um número máximo de instâncias de contêiner
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Saiba como definir o número máximo de instâncias de contêiner que podem ser usadas para
seu serviço do Knative serving. Especificar o máximo de instâncias no Knative serving permite limitar o escalonamento do serviço em resposta a solicitações recebidas. Use essa configuração como uma maneira de controlar custos ou
de limitar o número de conexões com um
serviço de apoio, como um banco de dados.
Para mais informações sobre como o Knative serving faz o escalonamento automático
das instâncias de contêiner, consulte
Escalonamento automático de instâncias.
Como configurar e atualizar o número máximo de instâncias
Qualquer mudança na configuração leva à criação de uma nova revisão. As próximas revisões também receberão automaticamente
essa configuração, a menos que você faça atualizações explícitas para alterá-la.
Por padrão, o número de instâncias de contêiner pode ser escalonado infinitamente. É possível definir
um limite para o número máximo de instâncias usando o
console do Google Cloud ou a Google Cloud CLI ao implantar um novo
serviço ou atualizar um que já existe e
implantar uma revisão:
Console
Acesse o Knative serving no console do Google Cloud:
Clique em Criar serviço se estiver configurando um
novo serviço em que fará uma implantação. Se você estiver configurando um
serviço atual, clique nele e em
Editar e implantar uma nova revisão.
Em Configurações avançadas, clique em Contêiner.
No campo Número máximo de
instâncias, especifique o número máximo desejado de instâncias
de contêiner.
Clique em Avançar para acessar a próxima seção.
Na seção Configurar como este serviço é acionado,
selecione qual conectividade você quer usar para invocar o serviço.
Clique em Criar para implantar a imagem no Knative serving e aguarde
até que a implantação seja concluída.
Linha de comando
Para serviços existentes, defina o número máximo de instâncias de contêiner
executando o comando gcloud run services update
com o parâmetro
--max-instances:
IMAGE_URL por uma referência à imagem de contêiner. Por
exemplo, gcr.io/cloudrun/hello;
MAX-VALUE pelo número máximo de instâncias de contêiner
que você quer. Especifique default para limpar qualquer configuração máxima
da instância.
YAML
Faça o download da configuração de um serviço existente para um
arquivo YAML com o comando gcloud run services describe usando a
sinalização --format=export.
Em seguida, modifique o arquivo YAML e implante
essas alterações com o comando gcloud run services replace.
Modifique apenas os atributos especificados.
Faça o download da configuração do serviço em um arquivo chamado
service.yaml no espaço de trabalho local:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-04-22 UTC."],[],[],null,["# Setting a maximum number of container instances\n\nLearn how to set the maximum number of container instances that can be used for\nyour Knative serving service. Specifying maximum instances in\nKnative serving allows you to limit the scaling of your service in\nresponse to incoming requests. Use this setting as a way to control your costs\nor to limit the number of connections to a backing service, such as to a\ndatabase.\n\nFor more information on the way Knative serving autoscales\ncontainer instances, refer to\n[Instance autoscaling](/kubernetes-engine/enterprise/knative-serving/docs/instance-autoscaling).\n\nSetting and updating maximum instances\n--------------------------------------\n\nAny configuration change leads to the\ncreation of a new revision. Subsequent revisions will also automatically get\nthis configuration setting unless you make explicit updates to change it.\n\nBy default, the number of container instances can scale infinitely. You can set\nan upper bound for the maximum number of instances using the\nGoogle Cloud console, or the Google Cloud CLI when you deploy a new\n[service](/kubernetes-engine/enterprise/knative-serving/docs/deploying#service) or update an existing service and\ndeploy a [revision](/kubernetes-engine/enterprise/knative-serving/docs/deploying#revision): \n\n### Console\n\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Click **Create Service** if you are configuring a\n new service you are deploying to. If you are configuring an\n existing service, click on the service, then click\n **Edit \\& Deploy New Revision**.\n\n3. Under *Advanced settings* , click **Container**.\n\n4. In the field labelled *Maximum number of\n instances*, specify the desired maximum number of container\n instances.\n\n5. Click **Next** to continue to the next section.\n\n6. In the **Configure how this service is triggered** section,\n select which connectivity you would like to use to invoke the service.\n\n7. Click **Create** to deploy the image to Knative serving and wait\n for the deployment to finish.\n\n### Command line\n\n- For existing services, set the maximum number of container instances by\n running the `gcloud run services update` command with the\n [`--max-instances`](/sdk/gcloud/reference/run/services/update#--max-instances)\n parameter:\n\n ```bash\n gcloud run services update SERVICE --max-instances MAX-VALUE\n ```\n\n Replace:\n - \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of your service.\n - \u003cvar translate=\"no\"\u003eMAX-VALUE\u003c/var\u003e with the desired maximum number of container instances. Specify `default` to clear any maximum instance setting.\n- For new services, set the maximum number of container instances by running\n the `gcloud run deploy` command with the\n [`--max-instances`](/sdk/gcloud/reference/run/deploy#--max-instances)\n parameter:\n\n ```bash\n gcloud run deploy SERVICE --image=IMAGE_URL --max-instances MAX-VALUE\n ```\n\n Replace:\n - \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of your service.\n - \u003cvar translate=\"no\"\u003eIMAGE_URL\u003c/var\u003e with a reference to the container image, for example, `gcr.io/cloudrun/hello`.\n - \u003cvar translate=\"no\"\u003eMAX-VALUE\u003c/var\u003e with the desired maximum number of container instances. Specify `default` to clear any maximum instance setting.\n\n### YAML\n\n| **Caution:** Deploying configuration changes using YAML files replaces the configuration of your existing services. Since a YAML file completely overwrites all configurations, you should avoid using multiple methods to modify your services. For example, do not use YAML files in conjunction with the Google Cloud console or `gcloud` commands.\n\nYou can download the configuration of an existing service into a\nYAML file with the `gcloud run services describe` command by using the\n[`--format=export`](/sdk/gcloud/reference/run/services/describe) flag.\nYou can then modify that YAML file and deploy\nthose changes with the `gcloud run services replace` command.\nYou must ensure that you modify only the specified attributes.\n\n1. Download the configuration of your service into a file named\n `service.yaml` on local workspace:\n\n ```bash\n gcloud run services describe SERVICE --format export \u003e service.yaml\n ```\n\n Replace \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of your\n Knative serving service.\n2. In your local file, update the `autoscaling.knative.dev/maxScale:`\n attribute:\n\n ```yaml\n spec:\n template:\n metadata:\n annotations:\n autoscaling.knative.dev/maxScale: '\u003cvar translate=\"no\"\u003eMAX-INSTANCE\u003c/var\u003e' \n ```\n\n Replace\n - \u003cvar translate=\"no\"\u003eMAX-INSTANCE\u003c/var\u003e with the desired maximum number.\n3. Replace the service with its new configuration using the following command:\n\n ```bash\n gcloud run services replace service.yaml\n ```"]]
