빠른 시작: GitHub Actions를 사용하여 Azure Database for PostgreSQL - 유연한 서버에 연결

적용 대상: Azure Database for PostgreSQL - 단일 서버 Azure Database for PostgreSQL - 유연한 서버

Azure Database for PostgreSQL 유연한 서버에 데이터베이스 업데이트를 배포하는 워크플로를 사용하여 GitHub Actions를 시작합니다.

필수 조건

다음 작업을 수행해야 합니다.

• 활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
• 샘플 데이터(data.sql)가 들어 있는 GitHub 리포지토리. GitHub 계정이 없는 경우 평가판에 가입하세요.
• Azure Database for PostgreSQL 유연한 서버 인스턴스.
  • 빠른 시작: Azure Portal에서 Azure Database for PostgreSQL - 유연한 서버 인스턴스 만들기

워크플로 파일 개요

GitHub Actions 워크플로는 리포지토리의 /.github/workflows/ 경로에 있는 YAML(.yml) 파일에서 정의됩니다. 이 정의는 워크플로를 구성하는 다양한 단계와 매개 변수를 포함합니다.

이 파일에는 다음 두 가지 섹션이 있습니다.

배포 자격 증명 생성

az ad sp create-for-rbac --name "myML" --role contributor \
                            --scopes /subscriptions/<subscription-id>/resourceGroups/<group-name> \
                            --json-auth

  {
    "clientId": "<GUID>",
    "clientSecret": "<GUID>",
    "subscriptionId": "<GUID>",
    "tenantId": "<GUID>",
    (...)
  }

Azure Database for PostgreSQL 유연한 서버 연결 문자열을 복사합니다.

Azure Portal에서 Azure Database for PostgreSQL 유연한 서버 인스턴스로 이동하여 설정>연결 문자열을 엽니다. ADO.NET 연결 문자열을 복사합니다. your_database 및 your_password의 자리 표시자 값을 바꿉니다. 연결 문자열은 다음과 비슷합니다.

psql host={servername.postgres.database.azure.com} port=5432 dbname={your_database} user={adminusername} password={your_database_password} sslmode=require

연결 문자열을 GitHub 비밀로 사용합니다.

GitHub 비밀 구성

워크플로 추가

1. GitHub 리포지토리에 대한 작업으로 이동합니다.

2. 워크플로 직접 설정을 선택합니다.

3. 워크플로 파일의 on: 섹션 뒤에 있는 모든 항목을 삭제합니다. 예를 들어 나머지 워크플로는 다음과 같습니다.

   name: CI
   
   on:
   push:
       branches: [ main ]
   pull_request:
       branches: [ main ]
   

4. 워크플로 이름을 PostgreSQL for GitHub Actions로 바꾸고, 체크 아웃 및 로그인 작업을 추가합니다. 이러한 작업은 사이트 코드를 체크 아웃하고 이전에 만든 GitHub 비밀을 사용하여 Azure에서 인증을 받습니다.

   • 서비스 주체
   • OpenID Connect

   name: PostgreSQL for GitHub Actions
   
   on:
   push:
       branches: [ main ]
   pull_request:
       branches: [ main ]
   
   jobs:
   build:
       runs-on: ubuntu-latest
       steps:
       - uses: actions/checkout@v1
       - uses: azure/login@v1
       with:
           creds: ${{ secrets.AZURE_CREDENTIALS }}
   

5. Azure PostgreSQL 배포 작업을 사용하여 Azure Database for PostgreSQL 유연한 서버 인스턴스에 연결합니다. POSTGRESQL_SERVER_NAME을 사용자의 서버 이름으로 바꿉니다. 리포지토리의 루트 수준에 data.sql이라는 Azure Database for PostgreSQL 유연한 서버 데이터 파일이 있어야 합니다.

    - uses: azure/postgresql@v1
      with:
       connection-string: ${{ secrets.AZURE_POSTGRESQL_CONNECTION_STRING }}
       server-name: POSTGRESQL_SERVER_NAME
       plsql-file: './data.sql'
   

6. Azure에서 로그아웃하는 작업을 추가하여 워크플로를 완성합니다. 완성된 워크플로는 다음과 같습니다. 파일이 리포지토리의 .github/workflows 폴더에 표시됩니다.

   • 서비스 주체
   • OpenID Connect

   name: PostgreSQL for GitHub Actions
   
   on:
   push:
       branches: [ main ]
   pull_request:
       branches: [ main ]
   
   
   jobs:
   build:
       runs-on: ubuntu-latest
       steps:
       - uses: actions/checkout@v1
       - uses: azure/login@v1
       with:
           client-id: ${{ secrets.AZURE_CREDENTIALS }}
   
   - uses: azure/postgresql@v1
     with:
       server-name: POSTGRESQL_SERVER_NAME
       connection-string: ${{ secrets.AZURE_POSTGRESQL_CONNECTION_STRING }}
       plsql-file: './data.sql'
   
       # Azure logout
   - name: logout
     run: |
        az logout
   

배포 검토

1. GitHub 리포지토리에 대한 작업으로 이동합니다.

2. 첫 번째 결과를 열어 워크플로 실행에 대한 자세한 로그를 확인합니다.

   

리소스 정리

Azure Database for PostgreSQL 유연한 서버 데이터베이스 및 리포지토리가 더 이상 필요하지 않으면 리소스 그룹 및 GitHub 리포지토리를 삭제하여 배포한 리소스를 정리합니다.

다음 단계