codespace에서 포트 전달

codespace 내에서 실행 중인 애플리케이션이 localhost URL(예: http://localhost:PORT 또는 http://127.0.0.1:PORT)이 포함된 터미널로 출력을 인쇄하면 포트가 자동으로 전달됩니다. 브라우저 또는 Visual Studio Code에서 GitHub Codespaces를 사용하는 경우 터미널의 URL 문자열은 로컬 컴퓨터에서 웹 페이지를 보기 위해 클릭할 수 있는 링크로 변환됩니다. 기본적으로 GitHub Codespaces은 HTTP를 사용하여 포트를 전달합니다.

또한 포트를 수동으로 전달하고, 전달된 포트에 레이블을 지정하고, 전달된 포트를 조직의 구성원과 공유하고, 전달된 포트를 공개적으로 공유하고, 전달된 포트를 codespace 구성에 추가할 수도 있습니다.

포트 전달

자동으로 전달되지 않은 포트는 수동으로 전달할 수 있습니다. 1. codespace에서 터미널을 엽니다.

1. 포트 탭을 클릭합니다.

2. 포트 목록에서 포트 추가를 클릭합니다.

   

3. 포트 번호 또는 주소를 입력한 다음 Enter 키를 누릅니다.

   

HTTPS 전달 사용

기본적으로 GitHub Codespaces는 HTTP를 사용하여 포트를 전달하지만 필요에 따라 HTTPS를 사용하도록 모든 포트를 업데이트할 수 있습니다. HTTPS를 사용하도록 공용 표시 유형으로 포트를 업데이트하는 경우 포트의 표시 유형이 자동으로 프라이빗으로 변경됩니다.

1. codespace에서 터미널을 엽니다.

2. 포트 탭을 클릭합니다.

3. 업데이트할 포트를 마우스 오른쪽 단추로 클릭한 다음 포트 프로토콜 변경을 마우스로 가리킵니다.

   

4. 이 포트에 필요한 프로토콜을 선택합니다. 선택한 프로토콜은 codespace의 수명 동안 이 포트에 대해 기억됩니다.

포트 공유

전달된 포트를 다른 사용자와 공유하려는 경우 포트를 조직에 대해 비공개 또는 공개로 지정할 수 있습니다. 조직에 대해 포트를 비공개로 설정하면 포트 URL이 있는 조직의 모든 사용자가 실행 중인 애플리케이션을 볼 수 있습니다. 포트를 공개로 지정하면 URL 및 포트 번호를 아는 모든 사용자가 인증할 필요 없이 실행 중인 애플리케이션을 볼 수 있습니다.

1. codespace에서 터미널을 엽니다.

2. 포트 탭을 클릭합니다.

3. 공유하려는 포트를 마우스 오른쪽 단추로 클릭하고 포트 표시 유형을 클릭한 다음 개인을 조직 또는 공용으로 클릭합니다.

   

4. 포트의 로컬 주소 오른쪽에 있는 복사 아이콘을 클릭합니다.

   

5. 복사한 URL을 포트를 공유하려는 사람에게 보냅니다.

명령줄 도구 및 REST 클라이언트를 사용하여 포트 액세스

포트를 전달하면 와 같은 https://USERNAME-CODESPACE-NAME-vrpqrxxrx7x2rxx-4000.preview.app.github.devURL에서 애플리케이션을 사용할 수 있게 됩니다. VS Code 데스크톱 애플리케이션에서 프라이빗 포트를 전달하는 경우 애플리케이션은 과 같은 127.0.0.1:4000localhost 포트에서도 사용할 수 있습니다.

Postman과 같은 REST 클라이언트 또는 curl과 같은 명령줄 도구를 사용하여 애플리케이션에 액세스하려면 localhost 포트를 사용하거나 원격 도메인의 공용 포트에 액세스하는 경우 인증할 필요가 없습니다. 그러나 원격 도메인의 프라이빗 포트에 연결하려면 요청에서 액세스 토큰을 GITHUB_TOKEN 사용하여 인증해야 합니다.

### 연결할 주소 찾기

1. codespace에서 터미널을 엽니다.

2. 포트 탭을 클릭합니다. 전달한 모든 포트가 나열됩니다.

3. 연결할 포트를 마우스 오른쪽 단추로 클릭하고 로컬 주소 복사를 클릭합니다.

   

4. 나중에 사용할 수 있는 위치에 복사한 주소를 붙여넣습니다.

GITHUB_TOKEN 찾기

1. codespace의 터미널에서 를 입력 echo $GITHUB_TOKEN합니다.

   토큰은 로 시작하는 ghu_문자열입니다.

2. 토큰을 복사합니다.

   중요: 이 액세스 토큰을 누구와도 공유하지 마세요.

   ### curl을 사용하여 전달된 포트에 액세스

로컬 컴퓨터의 터미널에서 다음을 입력합니다.

curl ADDRESS -H "X-Github-Token: TOKEN"

및 TOKEN 를 이전에 복사한 값으로 바꿉 있습니다ADDRESS.

Postman을 사용하여 전달된 포트에 액세스

1. Postman을 엽니다.

2. 새 GET 요청을 만듭니다.

3. 이전에 복사한 주소를 요청 URL로 붙여넣습니다.

   

4. 헤더 탭에서 키가 "X-Github-Token"이고 값이 이전에 복사한 값인 GITHUB_TOKEN 새 항목을 만듭니다.

   

5. 보내기를 클릭합니다. ## 포트 레이블 지정

브라우저 또는 VS Code 데스크톱 애플리케이션에서 codespace를 열면 전달된 포트에 레이블을 지정하여 목록에서 쉽게 식별할 수 있습니다.

1. codespace에서 터미널을 엽니다.

2. 포트 탭을 클릭합니다.

3. 레이블을 지정할 포트를 마우스로 가리킨 다음 레이블 아이콘을 클릭합니다.

4. 포트에 대한 레이블을 입력한 다음 Enter 키를 누릅니다.

   ## codespace 구성에 포트 추가

전달된 포트를 리포지토리에 대한 GitHub Codespaces 구성에 추가할 수 있으므로 리포지토리에서 만든 모든 Codespace에 대해 해당 포트가 자동으로 전달됩니다. 구성을 업데이트한 후 변경 내용을 적용하려면 이전에 만든 모든 codespace를 다시 빌드해야 합니다. 자세한 내용은 "개발 컨테이너 소개"을 참조하세요.

속성을 사용하여 forwardPorts 파일에서 .devcontainer.json 전달된 포트를 수동으로 구성하거나 브라우저 또는 VS Code 데스크톱 애플리케이션에서 연 codespace에서 "포트" 패널을 사용할 수 있습니다.

1. codespace에서 터미널을 엽니다.

2. 포트 탭을 클릭합니다.

3. codespace 구성에 추가할 포트를 마우스 오른쪽 단추로 클릭한 다음 레이블 설정 및 devcontainer.json 업데이트를 클릭합니다.

   

4. 포트에 대한 레이블을 입력한 다음 Enter 키를 누릅니다.

   

curl ADDRESS -H "X-Github-Token: TOKEN"

gh codespace ports forward CODESPACE-PORT:LOCAL-PORT

gh codespace ports visibility CODESPACE-PORT:SETTINGS

gh codespace ports visibility 80:private 3000:public 3306:org

curl ADDRESS -H "X-Github-Token: TOKEN"