로컬 JetBrains IDE를 사용하여 코드 개발

Cloud Workstations 플러그인을 사용하면 IntelliJ IDEA Ultimate, PyCharm, Professional, Rider, CLion, PhpStorm, WebStorm과 같은 JetBrains IDE를 사용하여 Cloud Workstations에 대한 원격 개발 세션을 시작할 수 있습니다.

지원되는 운영체제

Cloud Workstations 플러그인은 다음 운영체제를 지원합니다.

  • Windows
  • macOS(Intel 및 Apple Silicon)
  • Linux

지원되는 버전

Cloud Workstations 플러그인은 JetBrains IDE 및 JetBrains Gateway의 최신 버전과 이전 버전 하나를 지원합니다. 새 JetBrains IDE 주 버전이 출시되면 다음 Cloud Workstations 플러그인 출시 버전에서 새 버전을 지원하고 이전에 지원했던 가장 이른 버전의 지원을 중단합니다.

JetBrains 앱을 더 수월하게 최신 상태로 유지하려면 JetBrains 도구 상자도 설치하면 됩니다.

사전 구성된 기본 이미지의 JetBrains IDE 버전에 대한 자세한 내용은 Cloud Workstations 출시 노트를 참조하세요.

시작하기 전에

Cloud Workstations 플러그인을 설치하기 전에 다음 단계를 수행해야 합니다.

  1. 단계를 수행하여 워크스테이션을 만듭니다. 구성 메시지가 표시되면 사용하려는 JetBrains IDE에 해당하는 이미지를 선택합니다.

  2. 워크스테이션 이름을 입력한 후 만들기를 클릭합니다.

  3. 워크스테이션 페이지를 클릭하고 워크스테이션 생성이 완료될 때까지 기다립니다.

  4. 지원되는 버전의 JetBrains Gateway를 다운로드하고 설치합니다.

Cloud Workstations 플러그인 설치

  1. Cloud Workstations 플러그인을 설치합니다.

    1. JetBrains Gateway를 엽니다.

    2. 모든 제공업체를 선택합니다.

    3. 제공업체 추가 설치 섹션에서 Google Cloud를 찾은 후 설치를 클릭하여 Cloud Workstations 플러그인을 다운로드합니다.

      Cloud Workstations에 연결

  2. 설치하면 IDE를 원격으로 실행 섹션에 Cloud Workstations가 표시됩니다.

Cloud Workstations 플러그인을 사용하여 연결

플러그인을 사용하여 워크스테이션에 연결하려면 다음 단계를 수행합니다.

  1. JetBrains Gateway를 엽니다.

  2. IDE를 원격으로 실행 섹션에서 Google Cloud에 연결을 클릭합니다.

  3. 로그인을 클릭하여 Google 계정에 로그인합니다.

    1. 메시지를 따라 Cloud Workstations 플러그인에 Google Cloud에 대한 액세스 권한을 부여합니다.

    2. 계속을 클릭하여 로그인을 완료합니다.

  4. 찾아보기를 클릭하여 프로젝트 선택기 대화상자를 열고 클라우드 프로젝트를 선택합니다.

    Cloud Workstations에 연결

  5. 클라우드 프로젝트에서 워크스테이션을 선택하고 다음을 클릭한 후 선택한 워크스테이션이 시작할 때까지 기다립니다.

  6. IDE 및 프로젝트를 선택합니다.

    1. 원격 호스트에서 IDE 버전을 선택합니다.

    2. 원격 호스트에 IDE 프로젝트 경로를 입력합니다.

      IDE를 선택하고 프로젝트 이름을 입력합니다.

  7. 연결을 클릭하고 IDE와 프로젝트가 열릴 때까지 기다립니다.

워크스테이션에 다시 연결

워크스테이션과 IDE 프로젝트에 빠르게 다시 연결하려면 다음 안내를 따르세요.

  1. 최근 연결 패널을 엽니다.

  2. 프로젝트 경로를 클릭하여 Cloud Workstations에서 IDE를 엽니다.

    최근에 사용한 워크스테이션 목록

  3. IDE와 프로젝트가 열릴 때까지 기다립니다.

포트 전달 사용

JetBrains 클라이언트가 IDE 및 프로젝트와 함께 열리면 로컬 머신에서 Cloud Workstations의 원격 포트에 액세스할 수 있습니다. 예를 들어 워크스테이션에서 Python 서버를 실행하면 python -m SimpleHTTPServer 8080가 됩니다. 일부 경우에는 JetBrains Gateway가 자동으로 포트 전달을 수행하여 로컬 브라우저를 통해 원격으로 실행되는 프로젝트에 액세스할 수 있습니다.

다음과 같이 포트를 수동으로 Cloud Workstations에서 로컬 머신으로 전달할 수도 있습니다.

  1. Windows 및 Linux의 경우 기본 메뉴에서 파일 > 설정을 선택합니다.

    macOS의 경우 기본 메뉴에서 IntelliJ IDEA > 환경설정을 선택합니다.

  2. 도구 > 포트 전달로 이동하여 포트 8080의 TCP를 전달하는 새 규칙을 추가합니다.

  3. 이 규칙을 설정하면 http://localhost:8080에서 로컬로 Cloud Workstations의 포트 8080에 액세스할 수 있습니다.

API 엔드포인트 재정의

API 엔드포인트를 재정의해야 하는 Virtual Private Cloud 사용자의 경우 플러그인에서 클라우드 서비스에 연결할 수 있는지 확인합니다. API 엔드포인트를 재정의하려면 다음 단계를 수행합니다.

  1. Windows 및 Linux에서 settings옵션 메뉴 > 설정을 클릭합니다.

    macOS에서 settings 옵션 메뉴 > 환경설정을 클릭합니다.

  2. 선택사항: IntelliJ 및 기타 IDE의 JetBrains 설정에 액세스하려면 프로젝트 설정 구성을 참조하세요.

  3. 도구 > Google Cloud Workstations > 고급으로 이동합니다.

  4. API 엔드포인트 재정의 URL을 추가합니다.

  5. 적용을 클릭합니다.

Google Cloud에서 엔드포인트를 사용하는 방법에 대한 자세한 내용은 엔드포인트를 통한 Google API 액세스에 대한 Virtual Private Cloud 설명을 참조하세요.

BYOID 사용자를 위한 대체 연결 안내

BYOID를 사용하는 경우 Jetbrains 게이트웨이와 연결하기 위해 추가 단계를 수행해야 합니다. 다음 단계를 따르세요.

워크스테이션을 시작하고 TCP 연결 열기

다음 단계에서는 워크스테이션을 시작하고 TCP 연결을 엽니다.

  1. 시작하기 전에 섹션의 안내를 따릅니다.

  2. 워크스테이션이 실행 중인지 확인합니다. 다음 gcloud CLI 명령어를 사용하여 시작할 수 있습니다.

    gcloud workstations start WORKSTATION_ID –-project=PROJECT \
  --cluster=WORKSTATION_CLUSTER_ID --config=WORKSTATION_CONFIG_ID \
  --region=WORKSTATION_CLUSTER_REGION

  3. 포트 22에서 워크스테이션에 대한 TCP 터널을 시작합니다.

    gcloud workstations start-tcp-tunnel --project=PROJECT \
    --cluster=WORKSTATION_CLUSTER_ID \
    --config=WORKSTATION_CONFIG_ID \
    --region=WORKSTATION_CLUSTER_REGION \
    WORKSTATION_ID 22 --local-host-port=127.0.0.1:2222

초기 설정과 설치가 완료되면 다음 단계로 Jetbrains Gateway를 실행합니다.

Jetbrains Gateway 실행

  1. Jetbrains 게이트웨이를 실행한 후 SSH를 통해 연결을 선택합니다.

  2. SSH에 연결 페이지에서 설정을 클릭하여 새 연결을 설정합니다.

    SSH 구성 페이지에서 다음을 수행합니다.

    1. 새 연결 추가를 클릭합니다.
    2. 연결 정보를 입력합니다. 예를 들어 로컬 호스트=127.0.0.1, 포트=2222, 사용자 이름=user입니다. 로컬 호스트, 포트, 사용자 이름의 구성에 적합한 값을 사용해야 합니다.
    3. 인증 유형을 비밀번호로 설정하고 비밀번호 필드는 비워 둡니다.
    4. 파싱 구성 파일 ~/.ssh/config 옵션을 선택 해제합니다.
    5. OK(확인)를 클릭하여 연결을 만듭니다.
    6. 연결 확인 및 계속을 클릭합니다.

  3. IDE 및 프로젝트 선택 페이지에서 다음을 선택합니다.

    1. 사용할 IDE를 선택합니다.

    2. more_horiz 더보기를 클릭하여 프로젝트가 포함된 디렉터리를 선택합니다. 이 메뉴에서 프로젝트를 만들 수 없습니다. 프로젝트를 열기만 할 수 있습니다. 새 프로젝트를 만들려면 SSH 터미널 열기를 선택하고 명령어를 실행하여 JetBrains 프로젝트 디렉터리를 만듭니다.

      또는 SSH 터미널 열기를 클릭하여 워크스테이션 내에서 git 명령어를 실행할 수도 있습니다. 예를 들어 다음 명령어는 홈 디렉터리에 Cloud Code 샘플 프로젝트를 클론합니다.

      git clone https://github.com/GoogleCloudPlatform/cloud-code-samples.git

    3. 프로젝트 디렉터리를 선택한 후 IDE 다운로드 및 시작을 클릭합니다.

  4. IDE가 연결되면 Jetbrains IDE에서 직접 워크스테이션의 파일에 액세스할 수 있으며 Cloud Workstations 확장 프로그램을 사용하여 코드를 빌드하고 실행할 수도 있습니다.