• GitLab 18.1 이상을 위한 다운스트림 파이프라인 로그가 추가됨.

프로젝트에서 GitLab CI/CD 파이프라인을 사용하는 경우, GitLab for VS Code 확장 프로그램을 사용하여 IDE에서 직접 파이프라인을 시작, 모니터링, 업데이트할 수 있습니다.

사전 요구사항#

• 확장 프로그램을 인증하고 GitLab의 리포지터리에 연결합니다.

파이프라인 모니터링 및 관리#

확장 프로그램을 사용하여 프로젝트의 파이프라인을 모니터링하고 관리합니다.

사전 요구사항:

• 프로젝트에서 CI/CD 파이프라인을 사용해야 합니다.

• 현재 Git 브랜치에 머지 리퀘스트가 존재해야 합니다.

• 현재 Git 브랜치의 가장 최근 커밋에 CI/CD 파이프라인이 있어야 합니다.

파이프라인 상태 보기#

브랜치 파이프라인의 상태를 확인하려면 VS Code 하단의 상태 바를 확인합니다.

[

](/19.2/editor_extensions/visual_studio_code/img/status_bar_pipeline_v17_6.png)

가능한 상태는 다음과 같습니다:

• Pipeline canceled

• Pipeline failed

• Pipeline passed

• Pipeline pending

• Pipeline running

• Pipeline skipped

• No pipeline: 파이프라인이 아직 실행되지 않은 경우.

파이프라인 관리#

GitLab에서 CI/CD 파이프라인을 시작, 모니터링, 디버그하려면:

• VS Code 하단 상태 바에서 파이프라인 상태를 선택하여 Command Palette를 열고 사용 가능한 작업에 접근합니다.

• 원하는 작업을 선택하고 안내를 따릅니다:

Create New Pipeline from Current Branch

• Cancel Last Pipeline

• Download Artifacts from Latest Pipeline

• Retry Last Pipeline

• View Latest Pipeline on GitLab

CI/CD job 출력 보기#

현재 브랜치의 CI/CD job 출력을 보려면:

• 왼쪽 사이드바에서 GitLab ( tanuki )을 선택합니다.

• For current branch를 펼쳐 가장 최근 파이프라인을 봅니다.

• job을 선택하면 새 VS Code 탭에서 열립니다:

[

](/19.2/editor_extensions/visual_studio_code/img/view_job_output_v17_6.png)

다운스트림 파이프라인의 job 로그를 열려면:

• 브랜치 파이프라인 job 목록 아래에서 다운스트림 파이프라인을 찾습니다.

• 화살표 아이콘을 선택하여 다운스트림 파이프라인 정보를 펼치거나 접습니다.

• 다운스트림 파이프라인을 선택하면 새 VS Code 탭에서 job 로그가 열립니다.

파이프라인 알림 관리#

확장 프로그램은 현재 브랜치의 파이프라인이 완료되면 VS Code에 알림을 표시할 수 있습니다:

[

](/19.2/editor_extensions/visual_studio_code/img/pipeline_alert_v19_0.png)

파이프라인 알림을 켜거나 끄려면:

• VS Code에서 Settings 편집기를 엽니다:

macOS에서는 Command+,를 누릅니다.

• Windows 또는 Linux에서는 Control+,를 누릅니다.

• 구성에 따라 User 또는 Workspace 설정을 선택합니다.

• Extensions > GitLab > Other를 선택합니다.

• GitLab: Show Pipeline Update Notifications 아래에서 체크박스를 선택하거나 선택 해제합니다.

CI/CD 구성 관리#

확장 프로그램은 프로젝트의 CI/CD 구성을 만들고 관리하는 데 사용할 수 있는 도구도 제공합니다.

CI/CD 변수 자동 완성#

CI/CD 구성 파일을 작성하거나 편집할 때 변수 자동 완성 기능을 사용하여 변수를 빠르게 찾습니다.

사전 요구사항:

• CI/CD 구성 파일 이름이 .gitlab-ci로 시작하고 .yml 또는 .yaml로 끝나야 합니다. 예를 들어 .gitlab-ci.yml 또는 .gitlab-ci.production.yml

변수를 자동 완성하려면:

• VS Code에서 .gitlab-ci.yml 파일을 열고 해당 파일의 탭이 포커스 상태인지 확인합니다.

• 변수 이름 입력을 시작합니다. 확장 프로그램이 자동 완성 옵션을 표시합니다.

• 옵션을 선택하여 사용합니다:

[

](/19.2/editor_extensions/visual_studio_code/img/ci_variable_autocomplete_v16_6.png)

GitLab CI/CD 구성 테스트#

프로젝트의 GitLab CI/CD 구성을 로컬에서 테스트하려면:

• VS Code에서 .gitlab-ci.yml 파일을 열고 해당 파일의 탭이 포커스 상태인지 확인합니다.

• Command Palette를 엽니다:

macOS에서는 Command+Shift+P를 누릅니다.

• Windows 또는 Linux에서는 Control+Shift+P를 누릅니다.

• GitLab: Validate GitLab CI Config를 입력하고 Enter를 누릅니다.

확장 프로그램은 구성에 문제가 발견되면 알림을 표시합니다.

병합된 구성 파일 보기#

모든 includes와 참조가 해결된 병합된 CI/CD 구성 파일 미리보기를 보려면:

• VS Code에서 .gitlab-ci.yml 파일을 열고 해당 파일의 탭이 포커스 상태인지 확인합니다.

• 오른쪽 상단에서 Show Merged GitLab CI/CD Configuration을 선택합니다:

[

](/19.2/editor_extensions/visual_studio_code/img/show_merged_configuration_v17_6.png)

VS Code가 전체 정보가 담긴 새 탭(.gitlab-ci (Merged).yml)을 엽니다.

관련 주제#

• CI/CD를 사용하여 애플리케이션 빌드