initial commit

README.es.md

@@ -0,0 +1,79 @@
+# 🐳 kiro-server Dev Container con Docker-in-Docker
+
+Un contenedor de desarrollo impulsado por [kiro-server](https://kiro.dev), con soporte completo para Docker usando Docker-in-Docker (DinD). Todo se configura fácilmente mediante variables de entorno en `.env`.
+
+## Características
+
+- 💻 kiro-server (VS Code en el navegador)
+- 🐳 Docker-in-Docker (DinD)
+- 🔐 Autenticación por contraseña o hash
+- 👤 Configuración dinámica de usuario (UID, GID, contraseña)
+- ⚙️ Herramientas preinstaladas: Docker, AWS CLI v2, kubectl, eksctl, Node.js, Python, Java, y más.
+
+## Construcción
+
+```bash
+docker build -t kiro-server-dind .
+```
+
+## Configuración por Entorno (`.env`)
+
+Crea un archivo `.env` con tus preferencias:
+
+```env
+DOCKER_USER=kiro
+UID=1000
+GID=1000
+TZ=Asia/Taipei
+PASSWORD=tucontraseña
+# O alternativamente:
+# HASHED_PASSWORD=$argon2id$v=19$m=65536,t=3,p=4$...
+```
+
+> **Nota:** Solo debes definir `PASSWORD` o `HASHED_PASSWORD`. Usa `PASSWORD=none` para desactivar la autenticación.
+
+## Ejecución
+
+```bash
+docker run --rm -it \
+  --privileged \
+  -v kiro-server-home:/home/coder \
+  --env-file .env \
+  -p 8080:8080 \
+  kiro-server-dind
+```
+
+## Volumen
+
+Todo el trabajo se guarda en `/home/coder`, montado mediante el volumen `kiro-server-home`.
+
+## Modos de Autenticación
+
+- `PASSWORD=tuclave`: contraseña en texto plano.
+
+## Acceso
+
+Una vez corriendo, visita: [http://localhost:8080](http://localhost:8080)
+Inicia sesión con las credenciales de tu archivo `.env`.
+
+## Herramientas Incluidas
+
+- Docker CLI
+- AWS CLI v2
+- kubectl (`v1.33.0`)
+- eksctl
+- Node.js + npm
+- Python 3 + pipx + venv
+- Java (default-jre)
+- siege, jq, git, y más.
+
+## Limpieza
+
+```bash
+docker volume rm kiro-server-home
+```
+
+## Licencia
+
+Este documento se distribuye bajo los términos de la GNU General Public License v3 o posterior.
+Ver el archivo [LICENSE](LICENSE) para más detalles.