Skip to main content

docs repos 업데이트 시, Azure 파이프라인 연동 자동화

1. 사전 준비​

Azure DevOps Personal Access Token (PAT) 생성​

Azure DevOps 파이프라인에서 인증을 위해 **Personal Access Token (PAT)**이 필요합니다.

  1. Azure DevOps에 로그인합니다.

  2. 우측 상단의 프로필 아이콘 옆에 → User Settings 선택.

  3. Personal Access Tokens 섹션에서 + New Token 클릭.

  4. 토큰 정보 입력:

    • Name : 원하는 이름 지정 (예: Azure DevOps Pipeline Token)
    • Organization : Security365
    • Expiration : 필요에 따라 유효 기간 설정 (예: 90일 또는 사용자 지정).
    • Scopes : Full access

  5. Create 버튼 클릭 후, 생성된 토큰을 복사하여 안전한 곳에 저장합니다. (해당 토큰은 창을 닫으면 확인할 수 없기 때문에, 창을 닫기 전 꼭 복사를 해서 기록합니다.)

azure-pipelines.yml 파일 존재 여부 확인​

해당 프로젝트의 docs repos에 azure-pipelines.yml 파일이 있는지 확인합니다. 해당 파일이 존재하지 않아야 아래 단계로 넘어갈 수 있으며, 존재한다면 해당 파일에 내용을 추가하는 작업이 필요합니다.

2. 파이프라인 등록​

1. Azure DevOps 로그인​

  • Azure DevOps 포털에 로그인합니다.

2. 프로젝트 선택​

  • 좌측 메뉴에서 등록할 프로젝트(예: SHIELDrive)를 선택합니다.

3. Pipelines 메뉴로 이동​

  • 상단 메뉴에서 Pipelines를 클릭합니다.

4. 새로운 파이프라인 생성​

  • New Pipeline 버튼을 선택합니다.

5. 파이프라인 소스 선택​

  • Where is your code? 화면에서 파이프라인을 등록할 레포지토리를 선택합니다.
  • Azure Repos Git을 선택한 후, docs 레포지토리를 선택합니다.

6. YAML 파일로 파이프라인 구성​

  • Configure your pipeline 화면에서 Starter pipeline 옵션을 선택합니다.

7. 스크립트 입력​

  • 스크립트 md 파일에 있는 스크립트를 입력하고, 변수 값을 프로젝트에 맞게 입력합니다.
  • 스크립트는 md 파일 code 형식으로 복사하여 입력합니다.

8. 변수 설정​

  • 상단에 있는 Variables 탭을 클릭합니다.
  • New variable 버튼을 클릭하여 새로운 변수를 추가합니다.
  • Name 필드에 변수 이름을 입력합니다 (예: AZURE_DEVOPS_PAT).
  • Value 필드에 복사한 토큰 값을 붙여넣습니다 .
  • Keep this value secret 옵션을 체크하여 값을 비밀로 설정합니다.
  • 모든 변수를 입력한 후 OK 버튼을 클릭하여 변수를 저장합니다.

9. 파이프라인 파일 커밋​

  • Save and run을 선택하여 파이프라인을 커밋하고 실행합니다.

10. 파이프라인 실행​

  • Run Pipeline 버튼을 클릭하여 파이프라인을 실행합니다.

11. 결과 확인​

  • 실행 결과 로그를 통해 각 단계가 정상적으로 완료되었는지 확인합니다.