에이전트에 대한 사용자 지정 환경 만들기

Linux 머신 또는 코드스페이스에서 고유한 도구 및 종속성을 사용하여 세션을 실행 Copilot 합니다.

이 기사에서

GitHub 또는 GitHub Actions에서 관리하는 클라우드 샌드박스를 사용하는 대신, GitHub Copilot 세션에 대한 사용자 지정 환경을 제공할 수 있습니다. 사용자 지정 환경은 Linux 머신 또는 코드스페이스에서 copilotd 호스트Copilot를 실행하는 환경입니다.

호스트를 만들고 GitHub 계정에 등록합니다. 그런 다음, 사용자 지정 환경을 지원하는 클라이언트에서 환경으로 선택할 수 있습니다. 등록하면 기존 호스트를 클라이언트에서 사용할 수 있게 합니다.

사용자 지정 환경에 대한 Copilot 라이선스 및 액세스 권한이 필요합니다. 사용자는 머신, 해당 작업 영역 및 도구를 담당하고 호스트를 최신 상태로 유지합니다. 클라이언트 연결을 닫아도 호스트 또는 컴퓨터가 중지되지 않습니다.

Linux 컴퓨터 사용

Copilot CLI를 사용하여 Linux 머신에서 호스트를 실행하고 등록하십시오.

1. 호스트 준비

사전 출시 버전을 Copilot CLI설치하려면 Linux 컴퓨터와 npm 또는 Homebrew가 필요합니다. 설치 요구 사항 및 기타 설치 방법은 GitHub Copilot CLI 설치을 참조하세요.

  1. 사용하려는 컴퓨터에서 작업 영역을 준비하고 에이전트 세션에 필요한 도구 및 종속성을 설치합니다.

  2. npm을 사용하여 Copilot CLI의 사전 릴리스 버전을 설치합니다.

    npm install -g @github/copilot@prerelease

    또는 Homebrew를 사용하여 설치하세요:

    brew install copilot-cli@prerelease

2. 호스트 등록

호스트는 인증하는 계정이 소유한 환경으로 등록됩니다.

  1. GitHub.com에 로그인하고 인증 프롬프트를 따릅니다.

    copilot login

  2. Copilot CLI를 시작하여 계정 설정 및 기능 플래그가 로드되도록 한 다음 대화형 세션을 종료합니다.

    copilot

  3. 환경 호스트를 시작합니다. HOST-NAME을 환경 선택기에서 인식할 이름으로 바꿉니다.

    copilot --environment-host "HOST-NAME"

    이 명령은 호스트를 시작하고 선택한 이름으로 컴퓨터를 등록합니다. 클라이언트가 연결할 수 있도록 호스트를 계속 실행합니다.

3. 환경 선택

등록된 환경 선택을 지원하는 클라이언트를 사용해 연결합니다.

  1. 호스트를 등록하는 데 사용한 것과 동일한 GitHub 계정으로 클라이언트에 로그인합니다.

  2. Environments를 열고 등록한 이름으로 호스트를 선택합니다.

    클라이언트는 에이전트 세션이 실행되는 실행 중인 호스트에 연결합니다.

GitHub Codespaces 사용하기

개발 컨테이너 기능을 사용하여 코드스페이스가 시작될 때 호스트를 자동으로 시작하고 등록합니다. GitHub Codespaces에 액세스해야 합니다. 아래 명령을 사용하려면 GitHub CLI의 인증된 설치도 필요합니다.

1. 코드스페이스 구성

개발 컨테이너 구성은 호스트가 설치되는 방식을 결정합니다.

  1. 리포지토리에서 .devcontainer/devcontainer.json을 만들거나 편집하여 호스트 기능을 추가합니다. 다음은 그 예입니다.

    {
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "features": {
    "ghcr.io/github/copilot-host/copilotd:0": {}
  }
}

  2. 선택적으로 사용자 환경에 대한 기능을 구성합니다. 시험판 채널에는 :prerelease 대신 :0을 사용합니다. 추가 리포지토리를 복제하려면 기능의 구성 개체 내에 repositories 옵션을 추가합니다.

    "ghcr.io/github/copilot-host/copilotd:0": {
  "repositories": "OWNER/REPOSITORY-1,OWNER/REPOSITORY-2"
}

OWNER/REPOSITORY-2 및 OWNER/REPOSITORY-1을 복제할 리포지토리의 소유자 및 이름으로 바꿉니다.

2. 호스트 시작 및 등록

이 기능은 copilotd 시작되며, 컨테이너가 시작될 때 코드스페이스를 자동으로 등록합니다.

  1. 새 코드스페이스를 만들려면 개발 컨테이너 구성을 커밋하고 푸시하세요. 그런 다음, 해당 브랜치에서 코드스페이스를 만듭니다. BRANCH를 리포지토리 소유자 및 이름으로 바꾸고 OWNER/REPOSITORY를 구성을 포함하는 브랜치로 바꾸세요.

    gh codespace create -r OWNER/REPOSITORY -b BRANCH

    기존 코드스페이스의 경우 대신 컨테이너를 다시 빌드하세요. CODESPACE-NAME를 코드스페이스의 이름으로 바꿉니다.

    gh codespace rebuild -c CODESPACE-NAME

  2. 컨테이너가 시작되고 호스트가 등록되기를 기다립니다.

3. 코드스페이스 환경 선택

등록된 환경 선택을 지원하는 클라이언트를 사용합니다. 클라이언트에 로그인하는 데 사용되는 토큰에는 codespace 범위가 포함되어야 합니다.

  1. 코드스페이스를 소유한 계정으로 GitHub 클라이언트에 로그인합니다.

  2. 환경을 열고 코드스페이스를 선택합니다.

    코드스페이스가 중지되면 연결하면 다시 활성화되고 copilotd가 자동으로 시작됩니다.

호스트 로그를 검사하려면 코드스페이스에서 다음 명령을 실행합니다.

tail -F /workspaces/.copilotd/logs/copilotd.log