워크스테이션에서 실행되는 HTTP 서버 액세스

기본적으로 브라우저에서 워크스테이션의 HTTP 포트 80 및 포트 1024~65535에 액세스할 수 있습니다. 워크스테이션 구성에서 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 앱에 연결

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

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

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

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

터미널에서 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 beta workstations configs create CONFIG \
        --cluster=CLUSTER \
        --region=REGION \
        --project=PROJECT \
        --allowed-ports=first=80,last=80 \
        --allowed-ports=first=8080,last=8100

CORS 프리플라이트 요청

기본적으로 워크스테이션 서비스는 워크스테이션에 대한 모든 요청이 쿠키 또는 인증 헤더로 인증되었는지 확인합니다.

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

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

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