Este documento explica como observar a aplicação de quotas. O sistema de quotas do Google Distributed Cloud (GDC) air-gapped protege os serviços ao impedir picos imprevistos na utilização que possam sobrecarregar os serviços. Para ajudar a compreender como as quotas de serviços são configuradas e aplicadas, pode usar o serviço Library Agent para observar os comportamentos das quotas, como a limitação de frequência.
O serviço Library Agent expõe duas APIs:
- GetShelf: recupera detalhes de uma estante específica e não tem limite de frequência.
- ListShelves: recupera uma lista de todas as estantes e tem um limite de frequência de dois pedidos por minuto.
Esta página destina-se a programadores no grupo de operadores de aplicações, que são responsáveis pela monitorização de quotas e padrões de utilização do respetivo projeto. Para mais informações, consulte o artigo Públicos-alvo para a documentação do GDC air-gapped.
Antes de começar
Antes de interagir com o serviço Library Agent, certifique-se de que tem as autorizações corretas e o ponto final do serviço:
Para receber as autorizações de que precisa para interagir com o serviço Library Agent, peça ao administrador de IAM do projeto que lhe conceda a função LibraryAgent User no espaço de nomes do projeto. Por exemplo, o administrador de IAM do projeto pode associar a função
libraryagent-userà sua conta de utilizador no espaço de nomes do projeto aplicando um recursoRoleBinding:kubectl apply -f - <<EOF apiVersion: rbac.authorization.k8s.io/v1 kind: RoleBinding metadata: name: libraryagent-user-binding namespace: PROJECT_NAMESPACE subjects: - kind: User name: USER_EMAIL_ADDRESS apiGroup: rbac.authorization.k8s.io roleRef: kind: Role name: libraryagent-user apiGroup: rbac.authorization.k8s.io EOFSubstitua o seguinte:
PROJECT_NAMESPACE: o espaço de nomes do seu projeto, comoproject-123.USER_EMAIL_ADDRESS: o endereço de email associado à sua identidade de utilizador.
Peça a um administrador da plataforma que tenha acesso ao cluster de administração da organização e que tenha a função de monitor de DNS (
dns-monitor-mp) para receber o nome de DNS do serviço Library Agent:kubectl get dnsregistration.network.private.gdc.goog -n libraryagent-system libraryagent -o jsonpath='{.status.fqdn}'Se precisar de editar o registo de DNS, o administrador da plataforma também tem de ter a função de depurador de DNS (
dns-debugger-mp).
Observe os limites de quotas
Para interagir com as APIs do Library Agent e observar a limitação de frequência, siga estes passos:
Defina variáveis de ambiente para o nome de DNS e o token de autenticação:
export DNS_NAME=LIBRARY_AGENT_DNS_NAME export TOKEN="$($HOME/gdcloud auth print-identity-token --audiences=https://$DNS_NAME)"Substitua
LIBRARY_AGENT_DNS_NAMEpelo nome de DNS que recebeu anteriormente.Chame a API
GetShelfpara obter uma estante específica pelo nome. Este método não tem limite de frequência:curl -v -X GET \ -H "Authorization: Bearer ${TOKEN?}" \ --insecure \ https://$DNS_NAME/v1alpha1/projects/PROJECT_NAMESPACE/shelves/Shelf1Substitua
PROJECT_NAMESPACEpelo espaço de nomes do projeto.Recebe uma resposta
HTTP 200 OK.Chame a API
ListShelvespara listar todas as estantes numa localização que se reflete no nome de DNS. Este método tem um limite de frequência de dois pedidos por minuto:curl -v -X GET \ -H "Authorization: Bearer ${TOKEN?}" \ --insecure \ https://$DNS_NAME/v1alpha1/projects/PROJECT_NAMESPACE/shelvesSubstitua
PROJECT_NAMESPACEpelo espaço de nomes do projeto.Se estiver dentro do limite de dois pedidos por minuto, recebe uma resposta
HTTP 200 OK.Para observar a aplicação de quotas, chame a API
ListShelvesrepetidamente até exceder o limite de frequência:curl -v -X GET \ -H "Authorization: Bearer ${TOKEN?}" \ --insecure \ https://$DNS_NAME/v1alpha1/projects/PROJECT_NAMESPACE/shelvesSubstitua
PROJECT_NAMESPACEpelo espaço de nomes do projeto.Quando excede o limite, recebe uma resposta
HTTP 429 Too Many Requestsa indicar que o pedido foi limitado em frequência pelo sistema de quotas. O resultado é semelhante ao seguinte:* Request completely sent off < HTTP/2 429 < x-envoy-ratelimited: true < date: Thu, 24 Apr 2025 18:37:16 GMT < server: istio-envoy < x-envoy-upstream-service-time: 46 < * Connection #0 to host libraryagent.org-1.zone1.google.gdch.test left intactA aplicação do limite de frequência nem sempre é precisa. Pode demorar mais de dois pedidos num minuto a acionar o erro 429.