{"meta":{"title":"캐시 관리","intro":"워크플로에서 만든 종속성 캐시를 모니터링하거나 필터링하고 삭제할 수 있습니다.","product":"GitHub Actions","breadcrumbs":[{"href":"/ko/actions","title":"GitHub Actions"},{"href":"/ko/actions/how-tos","title":"사용법"},{"href":"/ko/actions/how-tos/manage-workflow-runs","title":"워크플로 실행 관리"},{"href":"/ko/actions/how-tos/manage-workflow-runs/manage-caches","title":"캐시 관리"}],"documentType":"article"},"body":"# 캐시 관리\n\n워크플로에서 만든 종속성 캐시를 모니터링하거나 필터링하고 삭제할 수 있습니다.\n\n이 문서에서는 GitHub 웹 인터페이스를 사용하여 캐시를 관리하는 방법을 설명하지만, 캐시는 다음 방법으로도 관리할 수 있습니다:\n\n* REST API를 사용합니다.\n [GitHub Actions 캐시에 대한 REST API 엔드포인트](/ko/rest/actions/cache)을(를) 참조하세요.\n* 명령줄의 `gh cache` 하위 명령 사용.\n [GitHub CLI 설명서](https://cli.github.com/manual/gh_cache)를 참조하세요.\n\n## 캐시 항목 보기\n\n웹 인터페이스를 사용하여 리포지토리에 대한 캐시 항목 목록을 볼 수 있습니다. 캐시 목록에서는 각 캐시가 사용하는 디스크 공간, 캐시가 생성된 시기 및 캐시가 마지막으로 사용된 시기를 확인할 수 있습니다.\n\n1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.\n2. 리포지토리 이름에서 ** 작업**을 클릭합니다.\n\n \n3. 왼쪽 사이드바의 \"Management\" 섹션에서 ** Caches**를 클릭합니다.\n4. 리포지토리의 캐시 항목 목록을 검토합니다.\n\n * 특정 분기에 사용되는 캐시 항목을 검색하려면 **분기** 드롭다운 메뉴를 클릭하고 분기를 선택합니다. 캐시 목록에는 선택한 분기에 사용되는 모든 캐시가 표시됩니다.\n * 특정 캐시 키가 있는 캐시 항목을 검색하려면 `key: key-name` 필드의 구문 \\*\\*\\*\\* 을(를) 사용합니다. 캐시 목록에는 키가 사용된 모든 분기의 캐시가 표시됩니다.\n\n \n\n## 캐시 항목 삭제\n\n`write` 리포지토리에 액세스할 수 있는 사용자는 웹 인터페이스를 GitHub 사용하여 캐시 항목을 삭제할 수 있습니다.\n\n1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.\n2. 리포지토리 이름에서 ** 작업**을 클릭합니다.\n\n \n3. 왼쪽 사이드바의 \"Management\" 섹션에서 ** Caches**를 클릭합니다.\n4. 삭제할 캐시 항목의 오른쪽에서 을 클릭합니다 .\n\n \n\n## 캐시 항목 강제 삭제\n\n캐시에는 분기 범위 제한이 있습니다. 즉, 일부 캐시에는 사용 옵션이 제한되어 있습니다. 캐시 범위 제한에 대한 자세한 내용은 [종속성 캐싱 참조](/ko/actions/reference/workflows-and-actions/dependency-caching)을(를) 참조하세요. 특정 분기로 제한된 캐시가 많은 스토리지 할당량을 사용하는 경우 `default` 분기의 캐시가 높은 빈도로 생성되고 삭제될 수 있습니다.\n\n예를 들어 리포지토리에는 해당 분기로 제한되는 자체 캐시가 있는 많은 새로운 끌어오기 요청이 열릴 수 있습니다. 이러한 캐시는 해당 리포지토리에 대한 캐시 스토리지의 대부분을 차지할 수 있습니다.\n리포지토리가 최대 캐시 스토리지에 도달하면, 캐시 제거 정책에 따라 가장 오래전에 액세스된 캐시부터 최근에 액세스된 캐시 순으로 삭제하여 공간을 확보합니다. 이 경우 캐시 스래싱을 방지하기 위해 캐시 제거 정책보다 더 빠른 주기로 캐시를 삭제하도록 워크플로를 설정할 수 있습니다. 특정 분기에 대한 캐시를 삭제하는 데 사용할 GitHub CLI 수 있습니다.\n\n다음 예시 워크플로는 `gh cache`을(를) 사용하여 끌어오기 요청이 닫힌 후 분기에서 만든 캐시를 최대 100개까지 삭제합니다.\n\n리포지토리 간 끌어오기 요청 또는 포크에서 끌어오기 요청에서 다음 예제를 실행하려면 `pull_request_target` 이벤트를 사용하여 워크플로를 트리거하면 됩니다.\n`pull_request_target`를 사용하여 워크플로를 트리거하는 경우 보안에 유의해야 할 사항이 있습니다. 자세한 내용은 [워크플로를 트리거하는 이벤트](/ko/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\n또는 API를 사용하여 자체 주기에 따라 모든 캐시를 자동으로 나열하거나 삭제할 수 있습니다. 자세한 내용은 [GitHub Actions 캐시에 대한 REST API 엔드포인트](/ko/rest/actions/cache#about-the-cache-in-github-actions)을(를) 참조하세요."}