# Crear tu primer proyecto

Source : https://webgune.cloud/es-es/docs/premier-projet · Mis à jour le 2026-10-27

# Crear tu primer proyecto

Un **proyecto** agrupa los servicios que componen una misma aplicación: el frontend, la API, la base de datos. Cada proyecto vive en su propio namespace de Kubernetes, lo que aísla sus recursos y su red interna de los demás proyectos de tu cuenta.

## Crear el proyecto

1. Desde el dashboard, haz clic en **+ Nuevo proyecto**.
2. Dale un nombre claro (ej. `tienda-online`).
3. Confirma: el proyecto está listo de inmediato, todavía vacío.

## Añadir un primer servicio

Una vez dentro del proyecto, haz clic en **+ Nuevo servicio** y elige una fuente:

- **GitHub**: despliega un repositorio, ver [Desplegar desde GitHub](/docs/deployer-github).
- **Imagen Docker**: despliega una imagen existente, ver [Desplegar una imagen Docker](/docs/deployer-docker).
- **Base de datos**: aprovisiona PostgreSQL, MySQL, MongoDB o Redis, ver [Bases de datos](/docs/bases-de-donnees).

## Ejemplo de estructura

```text
Proyecto "tienda-online"
├── frontend     — Next.js, desplegado desde GitHub
├── api          — Node.js, desplegado desde GitHub
└── db           — PostgreSQL, base gestionada
```

## Comunicación entre servicios

Los servicios de un mismo proyecto se comunican por su nombre a través del DNS interno del clúster, sin pasar por Internet:

```text
http://api.<namespace>.svc.cluster.local:3000
```

Es esta URL interna la que hay que usar para conectar tu `frontend` con tu `api`, o tu `api` con su base de datos. La URL pública es más lenta e innecesaria para tráfico interno.