docs/translations/es-ES/content/codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project.md

title, intro, permissions, redirect_from, versions, type, topics

title	intro	permissions	redirect_from	versions	type	topics
Configurar Codespaces para tu proyecto	Puedes utilizar un archivo de `devcontainer.json` para definir un ambiente de {% data variables.product.prodname_codespaces %} para tu repositorio.	People with write permissions to a repository can create or edit the codespace configuration.	/github/developing-online-with-github-codespaces/configuring-github-codespaces-for-your-project /github/developing-online-with-codespaces/configuring-codespaces-for-your-project	free-pro-team *	how_to	Codespaces Set up Fundamentals

{% data reusables.codespaces.release-stage %}

Acerca de los contenedores dev

Un contenedor de desarrollo o contenedor dev es el ambiente que utilizan los {% data variables.product.prodname_codespaces %} para proporcionar las herramientas y tiempos de ejecución que necesita tu proyecto para su desarrollo. Cuando trabajas con un contenedor de dev en los {% data variables.product.prodname_codespaces %}, puedes ya sea utilizar la configuración predeterminada, utilizar una configuración predeterminada o crear tu propia configuración. La opción que elijas dependerá de las herramientas, tiempos de ejecución, dependencias y flujos de trabajo que el usuario pudiese necesitar para tener éxito en tu proyecto.

{% data variables.product.prodname_codespaces %} permite la personalización por proyecto y por rama con un archivo devcontainer.json. Este archivo de configuración determina el ambiente de cada codespace nuevo que cualquier persona cree en tu repositorio definiendo un contenedor de desarrollo que puede incluir marcos de trabajo, herramientas, extensiones y reenvío de puertos. También puede utilizarse un Dockerfile junto con el archivo devcontainer.json en la carpeta .devcontainer para definir todo lo que se necesita para crear una imagen de contenedor.

devcontainer.json

{% data reusables.codespaces.devcontainer-location %}

Puedes utilizar tu devcontainer.json para configurar los ajustes predeterminados para todo el ambiente de codespaces, incluyendo el editor, pero también puedes configurar ajustes específicos del editor para espacios de trabajo individuales de un codespace en un archivo llamado .vscode/settings.json.

Para obtener más información sobre la configuración y propiedades que puedes configurar en un devcontainer.json, consulta la referencia a devcontainer.json en la documentación de {% data variables.product.prodname_vscode %}.

Dockerfile

Un Dockerfile también vive en la carpeta .devcontainer.

Puedes agregar un Dockerfile a tu proyecto para definir una imagen de contenedor e instalar software. En el Dockerfile, puedes utilizar FROM para especificar la imagen de contenedor.

FROM mcr.microsoft.com/vscode/devcontainers/javascript-node:0-14

# ** [Optional] Uncomment this section to install additional packages. **
# USER root
#
# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
#     && apt-get -y install --no-install-recommends <your-package-list-here>
#
# USER codespace

Puedes utilizar la instrucción e RUN para instalar cualquier software y && para unir comandos.

Referencia tu Dockerfile en tu archivo de devcontainer.json utilizando la propiedad dockerfile.

{
  ...
  "build": { "dockerfile": "Dockerfile" },
  ...
}

Para obtener más información sobre cómo utilizar un Dockerfile en un contenedor de dev, consulta la sección Crear un contenedor de desarrollo en la documentación de {% data variables.product.prodname_vscode %}.

Utilizar la configuración predeterminada

Si no defines una configuración en tu repositorio, {% data variables.product.prodname_dotcom %} creará un codespace con una imagen base de Linux. La imagen base de Linux incluye lenguajes y tiempos de ejecución como Python, Node.js, JavaScript, TypeScript, C++, Java, .NET, PHP, PowerShell, Go, Ruby, y Rust. También incluye otras herramientas y utilidades de desarrollador como git, el CLI de GitHub, yarn, openssh y vim. Para ver todos los lenguajes, tiempos de ejecución y herramientas que se incluyen, utiliza el comando devcontainer-info content-url dentro de tu terminal del codespace y sigue la url que este produce.

Como alternativa, para obtener más información sobre todo lo que incluye la imagen básica de Linux, consulta el archivo más reciente del repositorio microsoft/vscode-dev-containers.

La configuración predeterminada es una buena opción si estás trabajando en un proyecto pequeño que utilice los lenguajes y herramientas que proporciona {% data variables.product.prodname_codespaces %}.

Utilizar una configuración de contenedor predefinida

Las definiciones predefinidas de contenedores incluyen una configuración común para u tipo de proyecto en particular y pueden ayudarte a iniciar rápidamente con una configuración que ya tenga las opciones adecuadas del contenedor, los ajustes de {% data variables.product.prodname_vscode %} y las extensiones de {% data variables.product.prodname_vscode %} que deben estar instaladas.

Utilizar una configuración predefinida es una gran idea si necesitas extensibilidad adicional. También puedes iniciar con una configuración predefinida y modificarla conforme lo requieras de acuerdo con los ajustes de tu proyecto.

1. Para acceder a la paleta de comandos, en la esquina superior izquierda, selecciona el menú de aplicaciones y haz clic en Paleta de comandos... desde el menú de Ver y luego comienza a teclear "Codespaces: Add Development Container Configuration Files...". Haz clic en Codespaces: Agregar archivos de configuración de contenedores de desarrollo...
2. Haz clic en la definición que quieras utilizar.
3. Sigue los mensajes para personalizar tu definición.
4. Haz clic en OK (aceptar).
5. Para aplicar los cambios, en la esquina inferior derecha de la pantalla, haz clic en Reconstruir ahora. Para obtener más información sbre reconstruir tu contenedor, consulta la sección "Acplicar los cambios a tu configuración".

Crear una configuración personalizada para un codespace

Si ninguna de las configuraciones predefinidas satisface tus necesidades, puedes crear una configuración personalizada si agregas un archivo devcontainer.json. {% data reusables.codespaces.devcontainer-location %}

En el archivo, puedes utilizar las llaves de configuración compatibles para especificar los aspectos del ambiente del codespace, como cuáles extensiones de {% data variables.product.prodname_vscode %} se instalarán.

{% data reusables.codespaces.vscode-settings-order %}

Puedes definir la configuración predeterminada del editor para {% data variables.product.prodname_vscode %} en dos lugares.

• La configuración del editor que se definió en .vscode/settings.json se aplica como una configuración con alcance de Workspace- en este codespace.
• La configuración del editor que se definió en la clave settings en devcontainer.json se aplica como una configuración con alcance de Remote [Codespaces] en este codespace.

Después de actualizar el archivo devcontainer.json, puedes reconstruir el contenedor para que tu codespace aplique los cambios. Para obtener más información, consulta la sección "Aplicar cambios a tu configuración".

Aplicar cambios a tu configuración

{% data reusables.codespaces.apply-devcontainer-changes %}

1. {% data reusables.codespaces.rebuild-command %}
2. {% data reusables.codespaces.recovery-mode %} Arreglar los errores en la configuración.
   • Para diagnosticar el error revisando la bitácora de creación, haz clic en Ver bitácora de creación.
   • Para arreglar los errores que se identificaron en las bitácoras, actualiza tu archivo devcontainer.json.
   • Para aplicar los cambios, vuelve a crear tu contenedor. {% data reusables.codespaces.rebuild-command %}