LXD를 사용하는 사용자 지정 실행자와 함께 사용하기
Tier: Free, Premium, Ultimate
Offering: GitLab.com, Self-Managed
이 예시에서는 빌드 당 하나의 컨테이너를 만들고 정리하는 데 LXD를 사용합니다.
이 예시에서는 각 단계마다 bash 스크립트를 사용합니다. 사용자 지정 이미지를 지정할 수 있으며, 이는 CI_JOB_IMAGE로 노출됩니다. 이 예시에서는 단순함을 위해 ubuntu:18.04
이미지를 사용합니다. 여러 이미지를 지원하려면 실행자를 수정해야 합니다.
이러한 스크립트에는 다음과 같은 전제 조건이 있습니다:
구성
[[runners]]
name = "lxd-driver"
url = "https://www.gitlab.com"
token = "xxxxxxxxxxx"
executor = "custom"
builds_dir = "/builds"
cache_dir = "/cache"
[runners.custom]
prepare_exec = "/opt/lxd-driver/prepare.sh" # lxd 컨테이너를 생성하고 의존성을 다운로드하기 위한 bash 스크립트 경로
run_exec = "/opt/lxd-driver/run.sh" # 컨테이너 내부에서 스크립트를 실행하는 bash 스크립트 경로
cleanup_exec = "/opt/lxd-driver/cleanup.sh" # 컨테이너를 삭제하기 위한 bash 스크립트 경로
기본
각 단계 준비, 실행 및 정리는 전체 스크립트에서 사용되는 변수를 생성하기 위해 이 스크립트를 사용합니다.
이 스크립트가 다른 스크립트와 동일한 디렉터리에 위치하는 것이 중요합니다. 이 경우 /opt/lxd-driver/
에 위치해야 합니다.
#!/usr/bin/env bash
# /opt/lxd-driver/base.sh
CONTAINER_ID="runner-$CUSTOM_ENV_CI_RUNNER_ID-project-$CUSTOM_ENV_CI_PROJECT_ID-concurrent-$CUSTOM_ENV_CI_CONCURRENT_PROJECT_ID-$CUSTOM_ENV_CI_JOB_ID"
준비
준비 스크립트에서는 다음을 수행합니다:
- 실행 중인 동일한 이름의 컨테이너를 삭제합니다.
- 컨테이너를 시작하고 시작될 때까지 대기합니다.
- 작업을 실행하는 데 필요한 사전 요구 사항을 설치합니다.
#!/usr/bin/env bash
# /opt/lxd-driver/prepare.sh
currentDir="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
source ${currentDir}/base.sh # 기본에서 변수 가져오기.
set -eo pipefail
# 모든 오류를 중단시키고 시스템 오류로 표시합니다.
trap "exit $SYSTEM_FAILURE_EXIT_CODE" ERR
start_container () {
if lxc info "$CONTAINER_ID" >/dev/null 2>/dev/null ; then
echo '이전 컨테이너를 찾았으므로 삭제합니다'
lxc delete -f "$CONTAINER_ID"
fi
# 컨테이너 이미지는 하드 코딩되어 있지만, 사용자가 이미지를 지정할 수 있도록 `CI_JOB_IMAGE` predefined 변수(https://docs.gitlab.com/ee/ci/variables/predefined_variables.html)를 사용할 수 있습니다. 몇 가지 수정이 필요할 수 있으므로 나머지 스크립트는 ubuntu 이미지에서 실행 중이라고 가정합니다.
lxc launch ubuntu:18.04 "$CONTAINER_ID"
# 컨테이너가 시작될 때까지 대기합니다. 간결성을 위해 systemd를 사용합니다.
for i in $(seq 1 10); do
if lxc exec "$CONTAINER_ID" -- sh -c "systemctl isolate multi-user.target" >/dev/null 2>/dev/null; then
break
fi
if [ "$i" == "10" ]; then
echo '컨테이너를 시작하기 위해 10초 대기 중, 종료 중..'
# 시스템 오류이므로 GitLab Runner에게 이를 시스템 오류로 표시하여 다시 시도해야 함을 알립니다.
exit "$SYSTEM_FAILURE_EXIT_CODE"
fi
sleep 1초
done
}
install_dependencies () {
# Git LFS 설치, git은 ubuntu 이미지에 미리 설치되어 있습니다.
lxc exec "$CONTAINER_ID" -- sh -c 'curl -s "https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh" | sudo bash'
lxc exec "$CONTAINER_ID" -- sh -c "apt-get install -y git-lfs"
# 캐시/아티팩트를 위해 gitlab-runner 이진 파일 설치가 필요합니다.
lxc exec "$CONTAINER_ID" -- sh -c 'curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64"'
lxc exec "$CONTAINER_ID" -- sh -c "chmod +x /usr/local/bin/gitlab-runner"
}
echo "$CONTAINER_ID에서 실행 중"
start_container
install_dependencies
실행
이 스크립트는 GitLab Runner에서 생성된 스크립트를 STDIN
을 통해 컨테이너로 전송하여 실행합니다.
#!/usr/bin/env bash
# /opt/lxd-driver/run.sh
currentDir="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
source ${currentDir}/base.sh # 기본에서 변수 가져오기.
lxc exec "$CONTAINER_ID" /bin/bash < "${1}"
if [ $? -ne 0 ]; then
# 빌드를 GitLab에서 실패로 만들기 위해 변수를 사용하여 종료합니다.
exit $BUILD_FAILURE_EXIT_CODE
fi
정리
빌드가 완료되었으므로 컨테이너를 삭제합니다.
#!/usr/bin/env bash
# /opt/lxd-driver/cleanup.sh
currentDir="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"
source ${currentDir}/base.sh # 기본에서 변수 가져오기.
echo "$CONTAINER_ID 컨테이너 삭제 중"
lxc delete -f "$CONTAINER_ID"