배포에 환경 사용

환경 정보

환경은 일반적인 배포 대상(예: production, staging 또는 development)을 설명하는 데 사용됩니다. GitHub Actions 워크플로가 환경에 배포되면 환경이 리포지토리의 기본 페이지에 표시됩니다. 작업을 진행하기 위해 승인을 요구하거나 워크플로, 사용자 지정 배포 보호 규칙을 사용하여 게이트 배포를 트리거할 수 있는 분기를 제한하거나 비밀에 대한 액세스를 제한할 수 있습니다. 환경을 만드는 방법에 대한 자세한 내용은 배포 환경 관리을(를) 참조하세요.

워크플로의 각 작업은 단일 환경을 참조할 수 있습니다. 환경을 참조하는 작업이 실행기에 전송되기 전에 환경에 대해 구성된 모든 보호 규칙이 전달되어야 합니다. 실행기에 작업이 전송된 후에만 작업이 환경의 비밀에 액세스할 수 있습니다.

워크플로가 환경을 참조하면 환경이 리포지토리의 배포에 표시됩니다. 현재 및 이전 배포 보기에 대한 자세한 내용은 배포 기록 보기을(를) 참조하세요.

워크플로에서 환경 사용

워크플로의 각 작업에 대한 환경을 지정할 수 있습니다. 이렇게 하려면 jobs.<job_id>.environment 키 뒤에 환경 이름을 추가합니다.

예를 들어 이 워크플로는 production이라는 환경을 사용합니다.

name: Deployment

on:
  push:
    branches:
      - main

jobs:
  deployment:
    runs-on: ubuntu-latest
    environment: production
    steps:
      - name: deploy
        # ...deployment-specific steps

위의 워크플로가 실행되면 deployment 작업에는 production 환경에 대해 구성된 모든 규칙이 적용됩니다. 예를 들어 환경에 검토자가 필요한 경우 검토자 중 한 명이 작업을 승인할 때까지 작업이 일시 중지됩니다.

환경에 대한 URL을 지정할 수도 있습니다. 지정된 URL은 리포지토리의 배포 페이지(리포지토리의 홈페이지에서 Environments(환경)를 클릭하여 액세스됨) 및 워크플로 실행에 대한 시각화 그래프에 표시됩니다. 끌어오기 요청이 워크플로를 트리거한 경우 URL은 끌어오기 요청 타임라인에 View deployment(배포 보기) 단추로도 표시됩니다. "병합 전에 배포가 성공해야 함" 규칙을 사용하는 경우 URL이 지정된 경우에도 지정된 name만 확인됩니다. 보호된 분기 정보을(를) 참조하세요.

name: Deployment

on:
  push:
    branches:
      - main

jobs:
  deployment:
    runs-on: ubuntu-latest
    environment: 
      name: production
      url: https://github.com
    steps:
      - name: deploy
        # ...deployment-specific steps