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

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

title	intro	permissions	redirect_from	versions	type	topics	product	shortTitle
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 /codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project /github/developing-online-with-codespaces/configuring-codespaces-for-your-project	fpt ghec * *	how_to	Codespaces Set up Fundamentals	{% data reusables.gated-features.codespaces %}	Configura tu proyecto

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. If your project does not already have a dev container defined, {% data variables.product.prodname_codespaces %} will use the default configuration, which contains many of the common tools that your team might need for development with your project. For more information, see "Using the default configuration."

If you want all users of your project to have a consistent environment that is tailored to your project, you can add a dev container to your repository. You can use a predefined configuration to select a common configuration for various project types with the option to further customize your project or you can create your own custom configuration. For more information, see "Using a predefined container configuration" and "Creating a custom codespace configuration." 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.

{% data reusables.codespaces.command-palette-container %}

1. Haz clic en la definición que quieras utilizar.
2. Sigue los mensajes para personalizar tu definición. For more information on the options to customize your definition, see "Adding additional features to your devcontainer.json file."
3. Haz clic en OK (aceptar).
4. 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".

Adding additional features to your devcontainer.json file

{% note %}

Note: This feature is in beta and subject to change.

{% endnote %}

You can add features to your predefined container configuration to customize which tools are available and extend the functionality of your workspace without creating a custom codespace configuration. For example, you could use a predefined container configuration and add the {% data variables.product.prodname_cli %} as well. You can make these additional features available for your project by adding the features to your devcontainer.json file when you set up your container configuration.

You can add some of the most common features by selecting them when configuring your predefined container. For more information on the available features, see the script library in the vscode-dev-containers repository.

You can also add or remove features outside of the Add Development Container Configuration Files workflow.

1. Access the Command Palette (Shift + Command + P / Ctrl + Shift + P), then start typing "configure". Select Codespaces: Configure Devcontainer Features.
2. Update your feature selections, then click OK.
3. 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 %}

{% data reusables.codespaces.rebuild-command %}

1. {% 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.