{"meta":{"title":"Gerenciando caches","intro":"Você pode monitorar, filtrar e excluir caches de dependência criados com base em seus fluxos de trabalho.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/actions","title":"GitHub Actions"},{"href":"/pt/actions/how-tos","title":"Instruções"},{"href":"/pt/actions/how-tos/manage-workflow-runs","title":"Gerenciar execuções de fluxos de trabalho"},{"href":"/pt/actions/how-tos/manage-workflow-runs/manage-caches","title":"Gerenciar caches"}],"documentType":"article"},"body":"# Gerenciando caches\n\nVocê pode monitorar, filtrar e excluir caches de dependência criados com base em seus fluxos de trabalho.\n\nEste artigo descreve o gerenciamento de caches com a interface da GitHub Web, mas você também pode gerenciá-los:\n\n* Uso da API REST. Confira [Pontos de extremidade da API REST para o cache do GitHub Actions](/pt/rest/actions/cache).\n* Com o subcomando `gh cache` da linha de comando. Confira a [Documentação da CLI do GitHub](https://cli.github.com/manual/gh_cache).\n\n## Exibir entradas de cache\n\nÉ possível usar a interface da Web para exibir uma lista das entradas de cache de um repositório. Na lista de cache, é possível ver quanto espaço em disco cada cache está usando, quando os caches foram criados e quando foram usados pela última vez.\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do repositório, clique em ** Actions**.\n\n \n3. Na barra lateral esquerda, na seção \"Management\", clique em ** Caches**.\n4. Revise a lista de entradas de cache do repositório.\n\n * Para pesquisar as entradas de cache usadas para um branch específico, clique no menu suspenso **Branch** e selecione um branch. A lista de cache exibirá todos os caches usados para o branch selecionado.\n * Para pesquisar entradas de cache com uma chave de cache específica, use a sintaxe `key: key-name` no campo **Filtrar caches**. A lista de cache exibirá caches de todos os ramos onde a chave foi usada.\n\n \n\n## Excluir entradas de cache\n\nOs usuários com `write` acesso a um repositório podem usar a interface da GitHub Web para excluir entradas de cache.\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do repositório, clique em ** Actions**.\n\n \n3. Na barra lateral esquerda, na seção \"Management\", clique em ** Caches**.\n4. À direita da entrada de cache que você deseja excluir, clique em .\n\n \n\n## Forçar a exclusão de entradas de cache\n\nOs caches têm restrições de escopo de ramificação em vigor, o que significa que alguns caches têm opções de uso limitadas. Para obter mais informações sobre as restrições do escopo de cache, confira [Referência do cache de dependência](/pt/actions/reference/workflows-and-actions/dependency-caching). Se caches limitados a um branch específico estiverem usando um excesso de cota de armazenamento, isso poderá fazer com que os caches do branch `default` sejam criados e excluídos com alta frequência.\n\nPor exemplo, um repositório pode ter muitas novas solicitações de pull abertas, cada qual com caches próprios restritos a um branch específico. Esses caches podem ocupar a maior parte do armazenamento em cache do repositório em questão.\nApós um repositório atingir seu volume máximo de armazenamento em cache, a política de remoção de cache criará espaço excluindo os caches na ordem da última data de acesso, da mais antiga para a mais recente. Para evitar a eliminação de cache nessa situação, você pode configurar fluxos de trabalho que excluam caches em uma cadência mais rápida do que a política de remoção de cache. Você pode usar o GitHub CLI para excluir caches de ramificações específicas.\n\nO fluxo de trabalho de exemplo a seguir usa `gh cache` para excluir até 100 caches criados por uma ramificação depois que uma pull request é fechada.\n\nPara executar o exemplo a seguir em solicitações de pull entre repositórios ou solicitações de pull de bifurcação, acione o fluxo de trabalho com o evento `pull_request_target`. Quando você usa `pull_request_target` para acionar o fluxo de trabalho, algumas considerações de segurança são necessárias. Para saber mais, confira [Eventos que disparam fluxos de trabalho](/pt/actions/reference/workflows-and-actions/events-that-trigger-workflows#pull_request_target).\n\n```yaml\nname: Cleanup github runner caches on closed pull requests\non:\n pull_request:\n types:\n - closed\n\njobs:\n cleanup:\n runs-on: ubuntu-latest\n permissions:\n actions: write\n steps:\n - name: Cleanup\n run: |\n echo \"Fetching list of cache keys\"\n cacheKeysForPR=$(gh cache list --ref $BRANCH --limit 100 --json id --jq '.[].id')\n\n ## Setting this to not fail the workflow while deleting cache keys.\n set +e\n echo \"Deleting caches...\"\n for cacheKey in $cacheKeysForPR\n do\n gh cache delete $cacheKey\n done\n echo \"Done\"\n env:\n GH_TOKEN: ${{ github.token }}\n GH_REPO: ${{ github.repository }}\n BRANCH: refs/pull/${{ github.event.pull_request.number }}/merge\n```\n\nComo alternativa, você pode usar a API para listar ou excluir automaticamente todos os caches em sua cadência. Para saber mais, confira [Pontos de extremidade da API REST para o cache do GitHub Actions](/pt/rest/actions/cache#about-the-cache-in-github-actions)."}