Creación de un entorno personalizado para agentes

Como alternativa al uso GitHub Actions de espacios aislados en la nube administrados por GitHub, puede proporcionar un entorno personalizado para GitHub Copilot las sesiones. Un entorno personalizado es una máquina Linux o un espacio de código que ejecuta el Copilot host, copilotd.

Usted crea el host y lo registra con su cuenta GitHub. Después, puede seleccionarlo como entorno en un cliente que admita entornos personalizados. El registro hace que un host existente esté disponible para los clientes.

Necesita una Copilot licencia y acceso a entornos personalizados. Usted es responsable de la máquina, su área de trabajo y herramientas, y de mantener el equipo host en funcionamiento y actualizado. El cierre de una conexión de cliente no detiene el host ni la máquina.

Usar una máquina Linux

Usa Copilot CLI para ejecutar y registrar el host en una máquina Linux.

1. Preparar el host

Necesita una máquina Linux y npm o Homebrew para instalar la versión preliminar de Copilot CLI. Para conocer los requisitos de instalación y otros métodos de instalación, consulte Instalación de la CLI de GitHub Copilot.

En el equipo que desea usar, prepare el área de trabajo e instale las herramientas y dependencias que sus sesiones de agente necesitan.
Instale la versión preliminar de Copilot CLI con npm:
```
npm install -g @github/copilot@prerelease
```
Como alternativa, instálelo con Homebrew:
```
brew install copilot-cli@prerelease
```

2. Registre el host

El host se registra como un entorno propiedad de la cuenta con la que se autentica.

Inicie sesión en GitHub.com y siga las indicaciones de autenticación:
```
copilot login
```
Comience Copilot CLI para que la configuración de la cuenta y los flags de funcionalidad se carguen y salga de la sesión interactiva:
```
copilot
```
Inicie el host del entorno. Reemplace HOST-NAME por un nombre que reconocerá en el selector de entorno.
```
copilot --environment-host "HOST-NAME"
```
El comando inicia el host y registra la máquina bajo el nombre que eligió. Mantenga el host en ejecución para que los clientes puedan conectarse a él.

3. Elegir el entorno

Conéctese desde un cliente que admita la selección de entornos registrados.

Inicie sesión en el cliente con la misma GitHub cuenta que usó para registrar el host.
Abra Entornos y seleccione el host por el nombre que registró.

El cliente se conecta al host en ejecución, donde se ejecutan las sesiones del agente.

Uso de GitHub Codespaces

Usa una característica de contenedor de desarrollo para iniciar y registrar el host automáticamente cuando se inicie el codespace. Necesita acceso a GitHub Codespaces. Para usar los comandos siguientes, también necesita una instalación autenticada de GitHub CLI.

1. Configura el codespace

La configuración del contenedor de desarrollo determina cómo se configura el host.

En su repositorio, cree o edite .devcontainer/devcontainer.json para agregar la característica de host. Por ejemplo:

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

Si lo desea, configure la función para su entorno. Usa :prerelease en lugar de :0 para el canal de versión preliminar. Para clonar repositorios adicionales, agregue una repositories opción dentro del objeto de configuración de la característica:
```
"ghcr.io/github/copilot-host/copilotd:0": {
  "repositories": "OWNER/REPOSITORY-1,OWNER/REPOSITORY-2"
}
```
Reemplace OWNER/REPOSITORY-1 y OWNER/REPOSITORY-2 por los propietarios y nombres de los repositorios que se van a clonar.

2. Iniciar y registrar el host

La característica se inicia copilotd y registra el espacio de código automáticamente cuando se inicia el contenedor.

Para crear un nuevo codespace, haz commit y push de la configuración del contenedor de desarrollo. A continuación, cree un espacio de código en esa rama. Reemplace OWNER/REPOSITORY por el propietario y el nombre del repositorio, y BRANCH por la rama que contiene la configuración.
```
gh codespace create -r OWNER/REPOSITORY -b BRANCH
```
Para un Codespace existente, reconstruya su contenedor en su lugar. Reemplace CODESPACE-NAME por el nombre de su codespace.
```
gh codespace rebuild -c CODESPACE-NAME
```
Espere a que el contenedor se inicie y el host se registre.

3. Elija el entorno de Codespaces.

Use un cliente que admita la selección de entornos registrados. El token que se usa para iniciar sesión en el cliente debe incluir el alcance codespace.

Inicie sesión en el cliente con la GitHub cuenta propietaria del codespace.
Abra Entornos y seleccione el codespace.

Si el espacio de código se detiene, al conectarse, se reactiva y se inicia copilotd automáticamente.

Para inspeccionar los registros de host, ejecute el siguiente comando en el espacio de código:

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