Skip to content

00-setup.md

Latest commit

 

History

History
391 lines (270 loc) · 12.5 KB

00-setup.md

File metadata and controls

391 lines (270 loc) · 12.5 KB
Raw

00: Entorno de Desarrollo

En este paso, estás configurando el entorno de desarrollo para el taller.

Prerrequisitos

Consulta el documento README para la preparación.

Comenzando

Usar GitHub Codespaces

  1. Haz clic en este enlace 👉 Open in GitHub Codespaces

  2. Una vez que la instancia de GitHub Codespace esté lista, abre una terminal y ejecuta el siguiente comando para verificar si todo lo que necesitas ha sido instalado correctamente o no.

    # Python
python --version
    # Node.js
node --version
npm --version

    # JDK
java --version
    # .NET SDK
dotnet --list-sdks

  3. Verifica el estado de tu repositorio.

    git remote -v

    Deberías poder ver lo siguiente.

    origin  https://github.com/microsoft/github-copilot-vibe-coding-workshop.git (fetch)
origin  https://github.com/microsoft/github-copilot-vibe-coding-workshop.git (push)

    Si ves algo diferente a lo anterior, elimina la instancia de GitHub Codespace y créala nuevamente.

  4. Ve a la sección Configurar Servidores MCP.

👇👇👇 En su lugar, si prefieres usar VS Code en tu máquina local, sigue las instrucciones a continuación. La sección de abajo no aplica para aquellos que usan GitHub Codespaces. 👇👇👇

Usar Visual Studio Code

Instalar PowerShell 👉 Para Usuarios de Windows

  1. Verifica si ya has instalado PowerShell o no.

    # Bash/Zsh
which pwsh
    # PowerShell
Get-Command pwsh

    Si no ves la ruta del comando pwsh, significa que aún no has instalado PowerShell. Visita la página de instalación de PowerShell y sigue las instrucciones.

  2. Verifica la versión de tu PowerShell.

    pwsh --version

    Se recomienda 7.5.0 o superior. Si la tuya es menor que esa, visita la página de instalación de PowerShell y sigue las instrucciones.

Instalar git CLI

  1. Verifica si ya has instalado git CLI o no.

    # Bash/Zsh
which git
    # PowerShell
Get-Command git

    Si no ves la ruta del comando git, significa que aún no has instalado git CLI. Visita la página de instalación de git CLI y sigue las instrucciones.

  2. Verifica la versión de tu git CLI.

    git --version

    Se recomienda 2.39.0 o superior. Si la tuya es menor que esa, visita la página de instalación de git CLI y sigue las instrucciones.

Instalar GitHub CLI

  1. Verifica si ya has instalado GitHub CLI o no.

    # Bash/Zsh
which gh
    # PowerShell
Get-Command gh

    Si no ves la ruta del comando gh, significa que aún no has instalado GitHub CLI. Visita la página de instalación de GitHub CLI y sigue las instrucciones.

  2. Verifica la versión de tu GitHub CLI.

    gh --version

    Se recomienda 2.65.0 o superior. Si la tuya es menor que esa, visita la página de instalación de GitHub CLI y sigue las instrucciones.

  3. Verifica si has iniciado sesión en GitHub o no.

    gh auth status

    Si aún no has iniciado sesión, ejecuta gh auth login e inicia sesión.

Instalar Docker Desktop

  1. Verifica si ya has instalado Docker Desktop o no.

    # Bash/Zsh
which docker
    # PowerShell
Get-Command docker

    Si no ves la ruta del comando docker, significa que aún no has instalado Docker Desktop. Visita la página de instalación de Docker Desktop y sigue las instrucciones.

  2. Verifica la versión de tu Docker CLI.

    docker --version

    Se recomienda 28.0.4 o superior. Si la tuya es menor que esa, visita la página de instalación de Docker Desktop y sigue las instrucciones.

Instalar Visual Studio Code

  1. Verifica si ya has instalado VS Code o no.

    # Bash/Zsh
which code
    # PowerShell
Get-Command code

    Si no ves la ruta del comando code, significa que aún no has instalado VS Code. Visita la página de instalación de Visual Studio Code y sigue las instrucciones.

  2. Verifica la versión de tu VS Code.

    code --version

    Se recomienda 1.99.0 o superior. Si la tuya es menor que esa, visita la página de instalación de Visual Studio Code y sigue las instrucciones.

    NOTA: Puede que no puedas ejecutar el comando code. En este caso, sigue este documento para la configuración.

Iniciar Visual Studio Code

  1. Crea un directorio de trabajo.

  2. Ejecuta el comando para hacer fork de este repositorio y clonarlo a tu máquina local.

    gh repo fork microsoft/github-copilot-vibe-coding-workshop --clone

  3. Navega al directorio clonado.

    cd github-copilot-vibe-coding-workshop

  4. Ejecuta VS Code desde la terminal.

    code .

  5. Abre una nueva terminal dentro de VS Code y ejecuta el siguiente comando para verificar el estado de tu repositorio.

    git remote -v

    Deberías poder ver lo siguiente. Si ves microsoft en origin, deberías clonarlo nuevamente desde tu repositorio forkeado.

    origin  https://github.com/<tu ID de GitHub>/github-copilot-vibe-coding-workshop.git (fetch)
origin  https://github.com/<tu ID de GitHub>/github-copilot-vibe-coding-workshop.git (push)
upstream        https://github.com/microsoft/github-copilot-vibe-coding-workshop.git (fetch)
upstream        https://github.com/microsoft/github-copilot-vibe-coding-workshop.git (push)

  6. Verifica si ambas extensiones han sido instaladas o no – GitHub Copilot y GitHub Copilot Chat.

    # Bash/Zsh
code --list-extensions | grep github.copilot
    # PowerShell
code --list-extensions | Select-String "github.copilot"

    Si no ves nada, significa que aún no has instalado esas extensiones. Ejecuta el siguiente comando para instalar las extensiones.

    code --install-extension "github.copilot" --force && code --install-extension "github.copilot-chat" --force

Configurar Servidores MCP

  1. Asegúrate de que Docker Desktop esté funcionando si usas VS Code en tu máquina local.

  2. Establece la variable de entorno de $REPOSITORY_ROOT.

    # bash/zsh
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)
    # PowerShell
$REPOSITORY_ROOT = git rev-parse --show-toplevel

  3. Copia la configuración de los servidores MCP.

    # bash/zsh
cp -r $REPOSITORY_ROOT/docs/.vscode/. \
      $REPOSITORY_ROOT/.vscode/
    # PowerShell
Copy-Item -Path $REPOSITORY_ROOT/docs/.vscode/* `
          -Destination $REPOSITORY_ROOT/.vscode/ -Recurse -Force

  4. Abre la Paleta de Comandos presionando F1 o Ctrl+Shift+P en Windows o Cmd+Shift+P en Mac OS, y busca MCP: List Servers.

  5. Elige context7 y luego haz clic en Start Server.

  6. Elige awesome-copilot y luego haz clic en Start Server.

Verificar Modo Agente de GitHub Copilot

  1. Haz clic en el ícono de GitHub Copilot en la parte superior de GitHub Codespace o VS Code y abre la ventana de GitHub Copilot.

    Abrir GitHub Copilot Chat

  2. Si se te pide iniciar sesión o registrarte, hazlo. Es gratuito.

  3. Asegúrate de estar usando el Modo Agente de GitHub Copilot.

    Modo Agente de GitHub Copilot

  4. Selecciona el modelo ya sea GPT-4.1 o Claude Sonnet 4.

Configurar Modo Bestia

  1. Ingresa /mcp.awesome-copilot.get_search_prompt, seguido de palabras clave como "beast mode"

    Debería mostrar la lista de modos de chat bestia. Ingresa un prompt similar a 4.1 Beast Chat Mode. Luego se guardará bajo el directorio .github/chatmodes.

  2. Elige el modo 4.1-Beast en lugar del modo Agent. Automáticamente cambiará el LLM a GPT 4.1.

  3. Establece la variable de entorno de $REPOSITORY_ROOT.

    # bash/zsh
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)
    # PowerShell
$REPOSITORY_ROOT = git rev-parse --show-toplevel

  4. Copia la configuración del espacio de trabajo.

    # bash/zsh
cp $REPOSITORY_ROOT/docs/.vscode/settings.json \
   $REPOSITORY_ROOT/.vscode/settings.json
    # PowerShell
Copy-Item -Path $REPOSITORY_ROOT/docs/.vscode/settings.json `
          -Destination $REPOSITORY_ROOT/.vscode/settings.json -Force

Preparar Instrucciones Personalizadas

  1. Establece la variable de entorno de $REPOSITORY_ROOT.

    # bash/zsh
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)
    # PowerShell
$REPOSITORY_ROOT = git rev-parse --show-toplevel

  2. Copia las instrucciones personalizadas.

    # bash/zsh
cp -r $REPOSITORY_ROOT/docs/custom-instructions/setup/. \
      $REPOSITORY_ROOT/.github/
    # PowerShell
Copy-Item -Path $REPOSITORY_ROOT/docs/custom-instructions/setup/* `
          -Destination $REPOSITORY_ROOT/.github/ -Recurse -Force

Analizar Documento de Requisitos del Producto (PRD) y Diseñar API

  1. Asegúrate de estar usando el Modo Agente de GitHub Copilot con el modelo Claude Sonnet 4 o GPT-4.1.

  2. Agrega product-requirements.md a GitHub Copilot.

  3. Ingresa el prompt como el siguiente para que el Agente de GitHub Copilot genere un documento OpenAPI para ti. Este documento OpenAPI será la base de toda tu aplicación.

    Aquí tienes el PRD para ti. Lee cuidadosamente todo el PRD y haz lo siguiente para mí.

- Identifica primero todos los pasos que vas a hacer.
- Genera un documento OpenAPI en formato YAML.
- El documento OpenAPI debe capturar todos los endpoints de la API, parámetros y cargas útiles de solicitud/respuesta.
- Asume que el servidor de la API es `http://localhost:8080` y la URL base es `/api`.
- Guárdalo en el archivo `openapi.yaml` en la raíz del repositorio.

  4. Verifica que openapi.yaml se genere en la raíz del repositorio.

  5. Haz clic en el botón [keep] de GitHub Copilot para tomar el archivo openapi.yaml.

Bien. Has completado el paso "Entorno de Desarrollo". Vamos al PASO 01: Desarrollo Backend Python.

Disclaimer: Este documento ha sido localizado por GitHub Copilot. Por lo tanto, puede contener errores. Si encuentras alguna traducción que sea inapropiada o errónea, por favor crea un issue.