튜토리얼: 원격 머신을 Web IDE에 연결하기

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated
Self-Managed GitLab의 경우, 기본적으로이 기능을 사용할 수 있습니다. 관리자는 특징 플래그 중 vscode_web_ide를 비활성화하여 기능을 숨길 수 있습니다. 이 기능은 GitLab.com 및 GitLab Dedicated에서 사용할 수 있습니다. 이 기능은 프로덕션 환경에 사용할 준비가되지 않았습니다.

이 튜토리얼에서는 다음을 보여줍니다:

  • GitLab 외부에서 개발 환경을 생성하는 방법
  • 원격 머신을 Web IDE에 연결하는 방법

전제 조건

  • 루트 액세스가 있는 원격 가상 머신
  • 해당 머신으로 해결되는 도메인 주소
  • Docker 설치

Let’s Encrypt 인증서 생성

Let’s Encrypt 인증서를 생성하려면:

  1. 도메인을 원격 머신으로 지정하는 A 레코드를 생성하십시오(예: example.remote.gitlab.dev에서 10.0.2.2로).

    note
    도메인에 액세스 할 수없는 경우 DuckDNS와 같은 서비스를 사용할 수 있습니다.

  2. HTTPS를 활성화하려면 Certbot을 설치하십시오: 

    sudo apt-get update
sudo apt-get install certbot

  3. 인증서를 생성하십시오: 

    export EMAIL="YOUR_EMAIL@example.com"
export DOMAIN="example.remote.gitlab.dev"
   
certbot -d "${DOMAIN}" \
  -m "${EMAIL}" \
  --config-dir ~/.certbot/config \
  --logs-dir ~/.certbot/logs \
  --work-dir ~/.certbot/work \
  --manual \
  --preferred-challenges dns certonly
    note
    DuckDNS의 경우 Certbot DNS DuckDNS 플러그인을 사용해야합니다.

이제 인증서를 생성했으므로, 개발 환경을 생성하고 연결할 때입니다.

원격 개발 환경 연결

Web IDE에 ​​원격 개발 환경을 연결하려면:

  1. 개발 환경을 생성하십시오: 

    export CERTS_DIR="/home/ubuntu/.certbot/config/live/${DOMAIN}"
export PROJECTS_DIR="/home/ubuntu"
   
docker run -d \
  --name my-environment \
  -p 3443:3443 \
  -v "${CERTS_DIR}/fullchain.pem:/gitlab-rd-web-ide/certs/fullchain.pem" \
  -v "${CERTS_DIR}/privkey.pem:/gitlab-rd-web-ide/certs/privkey.pem" \
  -v "${PROJECTS_DIR}:/projects" \
  registry.gitlab.com/gitlab-org/remote-development/gitlab-rd-web-ide-docker:0.2-alpha \
  --log-level warn --domain "${DOMAIN}" --ignore-version-mismatch

    새로운 개발 환경은 자동으로 시작됩니다.

  2. 토큰을 가져옵니다: 

    docker exec my-environment cat TOKEN

  3. 원격 연결 구성.

원격 연결 구성

Web IDE에서 원격 연결을 구성하려면:

  1. Web IDE를 엽니다.
  2. 메뉴 막대에서 View > Terminal을 선택하거나 Control+`를 누릅니다.
  3. 터미널 패널에서 원격 연결 구성을 선택합니다.
  4. 포함 된 포트를 포함하여 원격 호스트의 URL을 입력하십시오(예: yourdomain.com:3443).
  5. 프로젝트 경로를 입력하십시오.
  6. 가져온 토큰을 입력하십시오.

또는 URL에서 매개변수를 전달하고 Web IDE에 ​​직접 연결할 수 있습니다:

  1. 다음 명령을 실행하십시오: 

    echo "https://gitlab-org.gitlab.io/gitlab-web-ide?remoteHost=${DOMAIN}:3443&hostPath=/projects"

  2. 해당 URL로 이동하고 가져온 토큰을 입력하십시오.

성공했습니다! 이제 개발 환경은 Web IDE에 연결된 원격 호스트로 실행됩니다.

관련 주제