사용자 지정 배포 보호 규칙 만들기

필수 조건

참고 항목

사용자 지정 배포 보호 규칙은 현재 공개 미리 보기 버전이며 변경될 수 있습니다.

배포 보호 규칙에 대한 일반적인 내용은 AUTOTITLE을(를) 참조하세요.

GitHub Apps을(를) 사용하여 사용자 지정 배포 보호 규칙 만들기

GitHub App을(를) 생성합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요. 다음과 같이 GitHub App을(를) 구성합니다.
1. 필요에 따라 "사용자 식별 및 권한 부여"의 콜백 URL 텍스트 필드에 콜백 URL을 입력합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.
2. "사용 권한"에서 리포지토리 권한을 선택합니다.
3. "작업" 오른쪽에서 드롭다운 메뉴를 클릭하고 액세스: 읽기 전용을 선택합니다.
```
    ![ 새 GitHub 앱에 대한 "리포지토리 권한" 섹션의 스크린샷입니다. 작업 권한은 "읽기 전용"으로 표시되고 주황색 윤곽선으로 표시됩니다.
```
4. "배포" 오른쪽에서 드롭다운 메뉴를 클릭하고 액세스: 읽기 및 쓰기를 선택합니다.
```
    ![ 새 GitHub 앱에 대한 "리포지토리 권한" 섹션의 스크린샷입니다. 배포 권한은 "Read and write"로 표시되고 주황색 윤곽선으로 표시됩니다.
```
5. "이벤트 구독"에서 배포 보호 규칙을 선택합니다.
```
    ![ 새 GitHub 앱에 대한 "이벤트 구독 섹션" 섹션의 스크린샷입니다. 배포 보호 규칙의 확인란은 주황색 윤곽선으로 표시됩니다.
```
리포지토리에 사용자 지정 배포 보호 규칙을 설치하고 사용 설정합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.

배포 승인 또는 거부하기

워크플로가 사용자 지정 배포 보호 규칙이 사용 설정된 환경을 참조하는 작업에 도달하면 GitHub에서 페이로드를 포함하는 사용자가 구성한 URL로 요청을 보냅니다. 배포 보호 규칙을 작성하여 페이로드에 따라 배포를 승인하거나 거부하는 REST API 요청을 자동으로 보낼 수 있습니다. 다음과 같이 REST API 요청을 구성합니다.

들어오는 요청의 유효성을 검사합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.
JWT(JSON Web Token)를 사용하여 GitHub App(으)로 인증합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.
웹후크 페이로드의 설치 ID를 사용하여 설치 토큰을 생성합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.

curl --request POST \
--url "http(s)://HOSTNAME/api/v3/app/installations/INSTALLATION_ID/ACCESS_TOKENS" \
--header "Accept: application/vnd.github+json" \
--header "Authorization: Bearer {jwt}" \
--header "Content-Type: application/json" \
--data \
'{ \
   "repository_ids": [321], \
   "permissions": { \
      "deployments": "write" \
   } \
}'

필요에 따라 GitHub에 다른 작업을 수행하지 않고 상태 보고서를 추가하려면 에 요청을 보냅니다. 요청 본문에서 을(를) 생략합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요. 동일한 배포에 상태 보고서를 최대 10번 게시할 수 있습니다. 상태 보고서는 Markdown 서식을 지원하며 최대 1024자까지 가능합니다.
요청을 승인하거나 거부하려면 에 요청을 보냅니다 . 요청 본문에서 속성을 또는 (으)로 설정합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.
필요에 따라 에 요청을 전송하여 워크플로 실행에 대한 승인 상태를 요청합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.
필요에 따라 GitHub에 대한 배포를 검토합니다. 자세한 내용은 AUTOTITLE을(를) 참조하세요.

사용자 지정 배포 보호 규칙 만들기

누가 이 기능을 사용할 수 있나요?

이 문서의 내용

필수 조건

GitHub Apps을(를) 사용하여 사용자 지정 배포 보호 규칙 만들기

배포 승인 또는 거부하기