한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
업무·자동화 · 판정 관망
그림을 글로 풀면
숨김 경로의 포함 조건
upload-artifact는 점으로 시작하는 파일과 폴더 안의 파일을 기본적으로 제외합니다.
- 대상
- 평가 보고서를 Actions 아티팩트로 남기는 개발자
- 무엇이 바뀜
- 숨김 파일 포함 옵션은 기본값이 false입니다.
- 왜 중요한가
- 업로드 성공만으로 필요한 파일이 모두 들어갔다고 볼 수 없습니다.
- 지금 할 일
- 필요한 경로와 내용을 검토한 뒤 포함·제외 규칙을 정하세요.
- 한계·미확인
- 개념 비유. 실제 업로드·내려받기·비밀 검사 시험 없음.
- 공식 출처
- github.com
- 확인일
- 2026-10-16
파일이 없었던 것과 선택에서 빠진 것을 구분하기
가상의 평가 작업이 일반 보고서와 .결과 폴더 안의 상세 기록을 만들었다고 합시다. 업로드된 묶음에 일반 보고서만 있다면 생성 실패를 단정하기 전에 실제 생성 경로와 업로드 대상 조건을 비교해야 합니다. 그림의 포장 상자 밖에 남은 폴더는 파일이 존재해도 선택에서 제외될 수 있다는 뜻입니다.
점으로 시작하는 경로가 기준
공식 upload-artifact README는 숨김 파일을 기본 제외하며 include-hidden-files로 포함할 수 있다고 설명합니다. 여기서 숨김은 이름이 점으로 시작하는 파일 또는 그런 폴더 안의 파일을 뜻합니다. Windows의 숨김 속성만 있고 점 접두사가 없는 경우는 이 정의에 해당하지 않습니다. 따라서 파일 탐색기에서 보이는지와 Action의 경로 선택 기준을 혼동하지 않아야 합니다.
포함 옵션보다 먼저 내용과 범위 검토하기
AINOW는 필요한 결과 목록을 정하고 민감한 설정이나 자격 증명이 함께 들어 있는지 검토한 뒤, 업로드 범위를 좁히고 path 제외 규칙을 적용할 것을 제안합니다. include-hidden-files를 켜는 것 자체는 비밀 검사 기능이 아닙니다. 마지막에는 내려받은 묶음의 파일 목록을 기대 목록과 대조하세요. 이 글은 공식 문서에 근거한 설명이며 워크플로 실행, 실제 전송이나 비밀 탐지 시험을 수행하지 않았습니다.
참고 원문: GitHub 공식 actions/upload-artifact 저장소 — 숨김 파일 처리 · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-16
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- actions/upload-artifact 공식 README main·v7 예시·2026-10-16 열람. include-hidden-files 기본 false와 점 접두사 정의. Action 설치·워크플로 실행 없음
- 확인일
- 2026-10-16
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. 실제 업로드·내려받기·비밀 검사 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.