Observe a aplicação de quotas

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:

  1. 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 recurso RoleBinding:

    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
    EOF
    

    Substitua o seguinte:

    • PROJECT_NAMESPACE: o espaço de nomes do seu projeto, como project-123.
    • USER_EMAIL_ADDRESS: o endereço de email associado à sua identidade de utilizador.
  2. 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:

  1. 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_NAME pelo nome de DNS que recebeu anteriormente.

  2. Chame a API GetShelf para 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/Shelf1
    

    Substitua PROJECT_NAMESPACE pelo espaço de nomes do projeto.

    Recebe uma resposta HTTP 200 OK.

  3. Chame a API ListShelves para 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/shelves
    

    Substitua PROJECT_NAMESPACE pelo espaço de nomes do projeto.

    Se estiver dentro do limite de dois pedidos por minuto, recebe uma resposta HTTP 200 OK.

  4. Para observar a aplicação de quotas, chame a API ListShelves repetidamente até exceder o limite de frequência:

    curl -v -X GET \
    -H "Authorization: Bearer ${TOKEN?}" \
    --insecure \
    https://$DNS_NAME/v1alpha1/projects/PROJECT_NAMESPACE/shelves
    

    Substitua PROJECT_NAMESPACE pelo espaço de nomes do projeto.

    Quando excede o limite, recebe uma resposta HTTP 429 Too Many Requests a 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 intact
    

    A aplicação do limite de frequência nem sempre é precisa. Pode demorar mais de dois pedidos num minuto a acionar o erro 429.