워크스테이션에서 실행되는 HTTP 서버에 연결

기본적으로 브라우저에서 워크스테이션의 HTTP 포트 80 및 포트 1024~65535에 연결할 수 있습니다. 워크스테이션 구성에서 setting allowedPorts 을(를) 설정하여 워크스테이션에서 연결할 수 있는 포트를 제한할 수 있습니다.

실행 중인 워크스테이션에는 원격 브라우저에서 HTTP를 사용하여 연결하는 데 사용할 수 있는 host 속성이 있습니다. API, Google Cloud CLI, Google Cloud 콘솔을 통해 실행 중인 워크스테이션에 대한 세부정보를 가져오거나 워크스테이션 내에서 자동으로 설정된 $WEB_HOST 환경 변수를 출력하여 host 속성을 찾을 수 있습니다. URL은 기본적으로 포트 80으로 연결됩니다.

기본 워크스테이션 URL 형식

host 속성 URL은 기본적으로 다음 형식을 사용합니다.

https://PORT-WORKSTATION_NAME.CLUSTER_ID.cloudworkstations.dev

자리표시자는 다음을 나타냅니다.

  • PORT: 포트 번호이며 기본 포트는 80입니다.
  • WORKSTATION_NAME: 워크스테이션 이름입니다.
  • CLUSTER_ID: 무작위로 생성된 클러스터 식별자

  • cloudworkstations.dev: 워크스테이션의 기본 도메인 이름입니다.

    커스텀 도메인의 URL은 다른 형식을 사용합니다. Cloud Workstations에서 커스텀 도메인 설정에 대한 자세한 내용은 Cloud Workstations용 커스텀 도메인 설정을 참조하세요.

URL을 변경하여 다른 포트에 연결

다른 포트로 연결하려면 다른 포트 번호를 프리픽스로 지정합니다. 예를 들어 다음 URL은 포트 9900에 연결됩니다.

https://9900-myworkstation.cluster-12345abcde.cloudworkstations.dev

이 예시에서는 다음에 주의하세요.

  • 9900: 포트 번호를 나타냅니다.
  • myworkstation: 워크스테이션 ID를 나타냅니다.
  • cluster-12345abcde: 클러스터 식별자를 나타냅니다.
  • cloudworkstations.dev: 워크스테이션의 기본 도메인 이름을 나타냅니다.

이러한 URL에는 사용자 인증이 필요합니다. 이러한 URL을 열려면 로그인하고 Cloud Workstations 사용자 IAM 역할 roles/workstations.user 또는 workstations.workstations.use 권한이 있어야 합니다.

콘솔 Google Cloud 에서 HTTP 앱에 연결

콘솔에서 워크스테이션에서 실행 중인 HTTP 앱에 연결할 수 있습니다. Google Cloud

사용할 권한이 있는 실행 중인 워크스테이션에 대해 실행 버튼이 표시됩니다. 기본적으로 이 버튼은 포트 80으로 연결됩니다. 실행 옆에 있는 arrow_drop_down펼치기 화살표를 클릭하면 대체 연결 옵션을 볼 수 있습니다. 포트로 웹 앱에 연결 옵션을 선택하면 연결할 다른 포트를 지정할 수 있습니다.

기본 편집기에서 HTTP 앱에 연결

Cloud Workstations 기본 편집기에서 워크스테이션에서 실행 중인 앱에 연결하려면 다음 안내 중 하나를 수행합니다.

  • 터미널에서 localhost 링크를 클릭합니다. 기본 편집기가 localhost 링크를 올바른 URL로 자동으로 리디렉션합니다.

    1. 터미널 창을 열려면 menu 메뉴 > 터미널 > 새 터미널을 클릭합니다. 또는 Control+Shift+`(또는 macOS에서는 Command+Shift+`)를 누릅니다.

    2. 명령 프롬프트에서 다음 명령어를 실행하여 localhost 링크를 표시합니다.

      echo http://localhost:PORT

      PORT를 80 또는 8080과 같은 포트 번호로 바꿉니다.

    3. Control(또는 macOS의 경우 Command)을 누른 상태에서 localhost 링크를 클릭합니다.
      브라우저에서 PORT-WORKSTATION-HOSTNAME이 열립니다.

  • 브라우저 창을 사용하여 https://PORT-WORKSTATION-HOSTNAME으로 이동합니다. 여기서 PORT는 포트 번호이고 WORKSTATION-HOSTNAME는 워크스테이션 호스트 이름입니다.

워크스테이션의 포트 액세스 제한

워크스테이션에서 연결할 수 있는 포트를 제한하려면 워크스테이션 구성에서 allowedPorts를 설정합니다.

단일 포트를 제한하려면 PortRange first 및 last 필드를 동일한 포트 번호로 설정합니다.

기본적으로 포트 22, 80, 1024~65535가 허용됩니다.

포트 액세스가 80 및 8080~8100으로 제한된 워크스테이션 구성을 만들려면 다음 Google Cloud CLI 명령어를 실행합니다.

    gcloud workstations configs create CONFIG \
        --cluster=CLUSTER_ID \
        --region=REGION \
        --project=PROJECT \
        --allowed-ports=first=80,last=80 \
        --allowed-ports=first=8080,last=8100

CORS 프리플라이트 요청

기본적으로 Cloud Workstations는 워크스테이션에 대한 모든 HTTP/HTTPS 요청이 쿠키 또는 인증 헤더를 사용하여인증되도록 합니다.

교차 출처 리소스 공유 (CORS) 프리플라이트 요청에는 쿠키 또는 커스텀 헤더가 포함되지 않으므로 미인증 상태로 간주되어 Cloud Workstations에서 차단됩니다. 관리자는 선택적으로 미인증 CORS 프리플라이트 요청이 워크스테이션에 수신되도록 허용할 수 있으며, 이 경우 워크스테이션의 대상 서버가 요청을 검증해야 합니다.

미인증 CORS 프리플라이트 요청을 허용하려면 다음 Google Cloud CLI 명령어를 실행합니다.

    gcloud beta workstations configs update CONFIG \
        --cluster=CLUSTER_ID \
        --region=REGION \
        --project=PROJECT \
        --allow-unauthenticated-cors-preflight-requests

HTTP 응답에서 localhost 대체 사용 중지

개발 중인 앱이 워크스테이션에서 제대로 실행되도록 하기 위해 Cloud Workstations는 워크스테이션의 HTTP 응답에서 localhost, 127.0.0.1, 0.0.0.0에 대한 참조를 워크스테이션의 호스트 이름으로 바꿉니다.

이로 인해 일부 애플리케이션이 방해를 받을 수 있습니다. 이 동작을 사용 중지하려면 다음 Google Cloud CLI 명령어를 실행합니다.

    gcloud beta workstations configs update CONFIG \
        --cluster=CLUSTER_ID \
        --region=REGION \
        --project=PROJECT \
        --disable-localhost-replacement