Docker화된 GitLab CI 파이프라인에서 Rsync 및 SSH를 사용하는 방법

rsync는 효율적인 알고리즘을 사용하여 대역폭 소비를 최소화하는 널리 사용되는 파일 동기화 유틸리티입니다. rsync의 일반적인 역할 중 하나는 웹 사이트 빌드를 원격 프로덕션 서버에 배포하는 것입니다. rsync의 다재다능함과 GitLab CI 파이프라인에서 제공하는 자동화를 결합하는 방법은 다음과 같습니다.

파이프라인 실행자

GitLab CI는 여러 유형의 파이프라인 실행기를 지원합니다. 이는 작업이 실행될 환경을 정의합니다. shell 실행자는 기본값이며 호스트 시스템에서 베어 메탈을 실행합니다. 이를 통해 파이프라인은 추가 구성 없이 호스트에서 사용 가능한 모든 명령을 사용할 수 있습니다. 가장 널리 사용되는 Linux 배포판은 rsync가 설치된 상태로 제공되므로 이 접근 방식을 이해하기 쉽습니다.

불행하게도 shell 실행기는 강력한 격리를 제공하지 않으며 시간이 지남에 따라 호스트 환경을 오염시킬 수 있습니다. 더 나은 대안은 docker 실행기로 각 CI 작업에 대해 새로운 Docker 컨테이너를 가동합니다. 모든 작업은 호스트에 영향을 미치지 않는 깨끗한 환경에서 실행됩니다.

여기서 단점은 Docker 기본 이미지가 일반적으로 rsync 또는 ssh를 포함하지 않는다는 것입니다. ubuntu:latest와 같은 공식 OS 이미지도 이러한 명령 없이 최소 빌드로 제공됩니다. 이렇게 하면 종속성을 추가하고 파일을 rsync하는 파이프라인 스크립트가 약간 더 복잡해집니다.

파이프라인에 rsync를 추가하는 방법은 다음과 같습니다. 계속하기 전에 사용 가능한 Docker 기반 GitLab Runner가 있는지 확인하세요. 또한 사용할 준비가 된 GitLab 프로젝트가 있다고 가정합니다.

준비하기

rsync를 사용하여 원격 SSH 호스트에 연결하려면 사용 가능한 SSH 키 쌍이 필요합니다. ssh-keygen -t rsa를 실행하여 공개 및 개인 키를 생성할 수 있습니다. 연결할 서버에 공개 키를 복사합니다.

다음으로 생성된 개인 키를 클립보드에 복사합니다.

cat ~/.ssh/id_rsa | xclip -selection c

GitLab 프로젝트로 이동하여 왼쪽 탐색 메뉴 하단의 설정을 클릭합니다. 하위 메뉴에서 “CI/CD” 항목을 클릭합니다. 결과 페이지에서 변수 섹션까지 아래로 스크롤합니다.

파란색 변수 추가 버튼을 클릭합니다. 키 필드에 새 변수 이름을 지정하십시오. 우리는 SSH_PRIVATE_KEY를 사용하고 있습니다. 선행 ----BEGIN 및 후행 -----END 줄을 포함하여 개인 키를 값 필드에 붙여넣습니다.

키를 CI 변수로 추가하면 나중에 파이프라인에서 참조할 수 있습니다. 파이프라인이 생성하는 컨테이너의 SSH 에이전트에 추가됩니다.

파이프라인 파일 추가

GitLab CI는 저장소에 있는 .gitlab-ci.yml 파일의 내용을 기반으로 작업을 실행합니다. GitLab은 자동으로 이 파일을 찾아 변경 사항을 분기에 푸시할 때 정의된 파이프라인을 실행합니다.

class="co4">deploy:class="co3">
  stageclass="sy2">: deployclass="co3">
  imageclass="sy2">: alpine:latestclass="co4">
  scriptclass="sy2">:
    - rsync -atv --delete --progress ./ user@example.com:/var/www/html

class="co4">deploy:class="co3">
  stageclass="sy2">: deployclass="co3">
  imageclass="sy2">: alpine:latestclass="co4">
  before_scriptclass="sy2">:
    - apk update && apk add openssh-client rsync
    - eval $class="br0">(ssh-agent -sclass="br0">)
    - echo class="st0">"$SSH_PRIVATE_KEY" | ssh-add -class="co4">
  scriptclass="sy2">:
    - rsync -atv --delete --progress ./ user@example.com:/var/www/html

- echo class="st0">"Host *ntStrictHostKeyChecking no" >> ~/.ssh/config

- echo class="st0">"$SSH_HOST_KEY" > ~/.ssh/known_hosts