Docs: añadir Home.md con guía de despliegue
This commit is contained in:
58
docs/Home.md
Normal file
58
docs/Home.md
Normal file
@@ -0,0 +1,58 @@
|
||||
# Inicio — Infra Portainer
|
||||
|
||||
Bienvenido a la wiki del repositorio **infra-portainer**. Esta página es la primera entrada y contiene la información esencial para desplegar Portainer usando Docker Compose.
|
||||
|
||||
---
|
||||
|
||||
## Propósito
|
||||
|
||||
Este repositorio contiene la infraestructura mínima para desplegar Portainer Community Edition (CE) con Docker Compose. Está pensado para facilitar la administración de contenedores y stacks en entornos pequeños o de laboratorio.
|
||||
|
||||
## Contenido principal
|
||||
|
||||
- `docker-compose.yaml`: definición del servicio Portainer (puertos, volúmenes y variables).
|
||||
- `.env` (variables de entorno): fichero donde pueden definirse variables de entorno (contraseñas, rutas, etc.).
|
||||
|
||||
## Puertos expuestos
|
||||
|
||||
- 9443: Interfaz web segura (HTTPS) de Portainer.
|
||||
- 8000: Puerto para el agente Edge (opcional).
|
||||
|
||||
## Despliegue rápido (modo local)
|
||||
|
||||
1. Sitúate en la carpeta del repositorio:
|
||||
|
||||
```powershell
|
||||
cd C:\Users\gustavo.roales.ICT-IBERIA\repos\infra-portainer
|
||||
```
|
||||
|
||||
2. (Opcional) revisa `.env` y adapta variables si existen.
|
||||
|
||||
3. Arranca con Docker Compose:
|
||||
|
||||
```powershell
|
||||
docker compose up -d
|
||||
# o, en sistemas con docker-compose clásico:
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
4. Verifica que el contenedor está corriendo:
|
||||
|
||||
```powershell
|
||||
docke ps --filter name=portainer
|
||||
```
|
||||
|
||||
5. Accede a la interfaz en: https://<HOST>:9443
|
||||
|
||||
## Buenas prácticas
|
||||
|
||||
- Asegúrate de tener un volumen persistente para `/data` (ya definido en `docker-compose.yaml`) para mantener la configuración.
|
||||
- No exponer puertos innecesarios a Internet sin un proxy y HTTPS correctamente configurado.
|
||||
|
||||
## Contribuciones a la documentación
|
||||
|
||||
Puedes editar esta documentación directamente en `docs/` dentro del repositorio y enviar tus cambios mediante Pull Request. Si en el futuro habilitas la wiki de Gitea, también podrás mantenerla allí.
|
||||
|
||||
---
|
||||
|
||||
Si quieres, puedo añadir más páginas (instalación avanzada, certificados TLS, backup/restore del volumen `data`, integración con Traefik, etc.). ¿Qué te gustaría añadir en la siguiente página?
|
||||
Reference in New Issue
Block a user