배포 만들기 및 관리

배포를 사용하면 원격 Git 저장소에 저장된 파이프라인과 같은 코드를 실행하도록 예약할 수 있습니다. 코드가 있는 디렉터리를 선택하고 다음 작업을 실행할 수 있습니다.

  • 원격 저장소에 연결된 배포를 만들고 관리합니다.
  • 원격 저장소에서 코드를 가져오고 정기적으로 코드를 실행하도록 트리거를 구성합니다.
  • 일정 또는 다른 트리거를 사용하여 파이프라인을 실행합니다.
  • 콘솔 내에서 직접 실행 로그를 확인합니다. Google Cloud 알림의 경우 Dataform 배포는 Cloud Logging 및 Cloud Monitoring과 통합됩니다.

제한사항

  • 배포에는 기본 제공 알림이 없습니다. Logging 및 Monitoring을 사용하여 알림을 구성해야 합니다.
  • Developer Connect를 사용한 인증은 연결만 지원하고 계정 커넥터는 지원하지 않습니다.

시작하기 전에

배포를 만들기 전에 다음 작업을 완료하세요.

필요한 역할

이 문서의 작업을 완료하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

커스텀 서비스 계정을 사용하여 배포를 실행하려면 커스텀 서비스 계정에 BigQuery 데이터 편집자 역할 (roles/bigquery.dataEditor)도 부여해야 합니다.

배포 만들기

Dataform 배포를 만들려면 다음 안내를 따르세요.

  1. 콘솔에서 파이프라인 및 연결 페이지로 이동합니다. Google Cloud

    파이프라인 및 연결로 이동

  2. 만들기 > 배포 만들기를 클릭합니다.

  3. 저장소 인증 유형을 선택한 후 다음 옵션 중 하나를 선택합니다.

    Developer Connect

    1. 저장소 및 브랜치를 선택합니다.
    2. 코드가 있는 디렉터리의 경로를 입력합니다.
    3. 배포 이름을 입력합니다.
    4. 배포 리전을 선택합니다.

    5. 일정 빈도 섹션에서 다음을 수행합니다.

      1. 반복 메뉴에서 예약된 파이프라인 실행 빈도를 선택합니다.
      2. 시간 필드에 예약된 파이프라인 실행 시간을 입력합니다.
      3. 시간대 메뉴에서 일정 시간대를 선택합니다.

      또는 주문형 을 선택하여 배포를 주문형으로 실행합니다.

    6. 선택사항: Google Cloud 프로젝트 ID를 입력합니다.

    7. 선택사항: 스키마 접미사를 입력합니다.

    8. 선택사항: 테이블 프리픽스를 입력합니다.

    9. 선택사항: 기본 스키마를 입력합니다 .

    10. 선택사항: 컴파일 변수를 입력합니다.

    11. 배포 를 클릭합니다.

    HTTPS

    1. 원격 Git 저장소의 URL을 입력합니다.
    2. 브랜치를 선택합니다.
    3. 코드가 있는 디렉터리의 경로를 입력합니다.
    4. HTTPS 원격의 개인 액세스 토큰이 포함된 보안 비밀을 입력합니다. 자세한 내용은 HTTPS를 통해 원격 저장소 연결을 참조하세요.
    5. 배포 이름을 입력합니다.
    6. 배포 리전을 선택합니다.

    7. 일정 빈도 섹션에서 다음을 수행합니다.

      1. 반복 메뉴에서 예약된 파이프라인 실행 빈도를 선택합니다.
      2. 시간 필드에 예약된 파이프라인 실행 시간을 입력합니다.
      3. 시간대 메뉴에서 일정 시간대를 선택합니다.

      또는 주문형 을 선택하여 배포를 주문형으로 실행합니다.

    8. 선택사항: Google Cloud 프로젝트 ID를 입력합니다.

    9. 선택사항: 스키마 접미사를 입력합니다.

    10. 선택사항: 테이블 프리픽스를 입력합니다.

    11. 선택사항: 기본 스키마를 입력합니다 .

    12. 선택사항: 컴파일 변수를 입력합니다.

    13. 배포 를 클릭합니다.

    SSH

    1. 원격 Git 저장소의 URL을 입력합니다.
    2. 브랜치를 선택합니다.
    3. 코드가 있는 디렉터리의 경로를 입력합니다.
    4. 사용자 비공개 키와 SSH 공개 호스트 키 값이 포함된 보안 비밀을 입력합니다. 자세한 내용은 SSH를 통해 원격 저장소 연결을 참조하세요.
    5. 배포 이름을 입력합니다.
    6. 배포 리전을 선택합니다.

    7. 일정 빈도 섹션에서 다음을 수행합니다.

      1. 반복 메뉴에서 예약된 파이프라인 실행 빈도를 선택합니다.
      2. 시간 필드에 예약된 파이프라인 실행 시간을 입력합니다.
      3. 시간대 메뉴에서 일정 시간대를 선택합니다.

      또는 주문형 을 선택하여 배포를 주문형으로 실행합니다.

    8. 선택사항: Google Cloud 프로젝트 ID를 입력합니다.

    9. 선택사항: 스키마 접미사를 입력합니다.

    10. 선택사항: 테이블 프리픽스를 입력합니다.

    11. 선택사항: 기본 스키마를 입력합니다 .

    12. 선택사항: 컴파일 변수를 입력합니다.

    13. 배포 를 클릭합니다.

배포 나열

만든 배포를 나열하려면 다음 안내를 따르세요.

  1. 콘솔에서 파이프라인 및 연결 페이지로 이동합니다. Google Cloud

    파이프라인 및 연결로 이동

  2. 배포 목록을 확인합니다.

배포 일정 만들기

배포 일정을 만들려면 다음 안내를 따르세요.

  1. 콘솔에서 파이프라인 및 연결 페이지로 이동합니다. Google Cloud

    파이프라인 및 연결로 이동

  2. 배포 탭을 클릭한 후 배포를 선택합니다.

  3. 배포 세부정보 페이지의 트리거 (워크플로 구성) 섹션에서 만들기 를 클릭합니다.

  4. 워크플로 구성 만들기 창에서 단계에 따라 워크플로 구성을 만듭니다.

배포 일정 실행

배포 일정을 실행하려면 다음 안내를 따르세요.

  1. 콘솔에서 파이프라인 및 연결 페이지로 이동합니다. Google Cloud

    파이프라인 및 연결로 이동

  2. 배포 탭을 클릭한 후 배포를 선택합니다.

  3. 트리거 (워크플로 구성) 섹션에서 실행할 배포 일정 옆에 있는 작업 보기 > 지금 실행을 클릭합니다.

배포 일정 삭제

배포 일정을 삭제하려면 다음 안내를 따르세요.

  1. 콘솔에서 파이프라인 및 연결 페이지로 이동합니다. Google Cloud

    파이프라인 및 연결로 이동

  2. 배포 탭을 클릭한 후 배포를 선택합니다.

  3. 배포 세부정보 페이지의 트리거 (워크플로 구성) 섹션에서 삭제할 배포 일정 옆에 있는 작업 보기 > 삭제를 클릭합니다.

알림 구성

워크플로 실행이 실패할 때 알림을 받으려면 실패한 워크플로 호출에 대한 알림을 구성합니다.

다음 단계