Docker Container Manager es una herramienta de línea de comandos diseñada para simplificar la gestión de contenedores Docker. Proporciona un conjunto de comandos para listar, iniciar, detener, ver registros, inspeccionar y monitorear estadísticas de contenedores. Esta herramienta es ideal para desarrolladores y administradores de sistemas que necesitan una manera rápida y fácil de gestionar contenedores Docker desde la línea de comandos.
- Listar Contenedores: Muestra una lista de todos los contenedores Docker.
- Iniciar un Contenedor: Inicia un contenedor Docker específico.
- Detener un Contenedor: Detiene un contenedor Docker específico.
- Ver Registros de Contenedor: Ve los registros de un contenedor Docker específico.
- Inspeccionar Contenedor: Obtiene información detallada sobre un contenedor Docker específico.
- Monitorear Estadísticas de Contenedor: Monitorea el uso de recursos de un contenedor Docker específico.
Antes de instalar Docker Container Manager, asegúrate de tener los siguientes prerrequisitos instalados en tu sistema:
- Go (Golang): Versión 1.16 o superior.
- Docker: Asegúrate de que Docker esté instalado y en funcionamiento en tu sistema.
Para instalar Docker Container Manager, sigue estos pasos:
-
Clonar el Repositorio:
git clone https://github.com/elliotsecops/GoDockerManager.git cd GoDockerManager -
Ejecutar el Script de Instalación:
./install.sh
El script construirá el proyecto y moverá el ejecutable a
/usr/local/bin/, haciéndolo disponible en todo el sistema.
Una vez instalado, puedes usar el comando docker-container-manager para gestionar tus contenedores Docker. A continuación se presentan los comandos disponibles y sus descripciones.
Para listar todos los contenedores Docker, usa el siguiente comando:
docker-container-manager listPara iniciar un contenedor Docker específico, usa el siguiente comando:
docker-container-manager start <containerID>Reemplaza <containerID> con el ID del contenedor que deseas iniciar.
Para detener un contenedor Docker específico, usa el siguiente comando:
docker-container-manager stop <containerID>Reemplaza <containerID> con el ID del contenedor que deseas detener.
Para ver los registros de un contenedor Docker específico, usa el siguiente comando:
docker-container-manager logs <containerID>Reemplaza <containerID> con el ID del contenedor cuyos registros deseas ver.
Para obtener información detallada sobre un contenedor Docker específico, usa el siguiente comando:
docker-container-manager inspect <containerID>Reemplaza <containerID> con el ID del contenedor que deseas inspeccionar.
Para monitorear el uso de recursos de un contenedor Docker específico, usa el siguiente comando:
docker-container-manager stats <containerID>Reemplaza <containerID> con el ID del contenedor que deseas monitorear.
Para desinstalar Docker Container Manager, sigue estos pasos:
-
Ejecutar el Script de Desinstalación:
./uninstall.sh
El script eliminará el ejecutable de
/usr/local/bin/.
¡Las contribuciones son bienvenidas! Si tienes alguna idea, sugerencia o informe de errores, por favor abre un issue o envía un pull request. Para cambios importantes, por favor discute tus ideas en un issue antes de hacer cualquier cambio.
- Haz un fork del repositorio.
- Crea una nueva rama (
git checkout -b feature/tu-nombre-de-característica). - Realiza tus cambios y confírmalos (
git commit -m 'Agregar alguna característica'). - Envía los cambios a la rama (
git push origin feature/tu-nombre-de-característica). - Abre un pull request.
Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.
¡Gracias por usar Docker Container Manager! Si tienes alguna pregunta o necesitas más ayuda, no dudes en ponerte en contacto.
Docker Container Manager is a CLI tool designed to simplify the management of Docker containers. It provides a set of commands to list, start, stop, view logs, inspect, and monitor container statistics. This tool is ideal for developers and system administrators who need a quick and easy way to manage Docker containers from the command line.
- List Containers: Display a list of all Docker containers.
- Start a Container: Start a specific Docker container.
- Stop a Container: Stop a specific Docker container.
- View Container Logs: View the logs of a specific Docker container.
- Inspect Container: Get detailed information about a specific Docker container.
- Monitor Container Statistics: Monitor the resource usage of a specific Docker container.
Before installing Docker Container Manager, ensure you have the following prerequisites installed on your system:
- Go (Golang): Version 1.16 or higher.
- Docker: Ensure Docker is installed and running on your system.
To install Docker Container Manager, follow these steps:
-
Clone the Repository:
git clone https://github.com/elliotsecops/GoDockerManager.git cd GoDockerManager -
Run the Installation Script:
./install.sh
The script will build the project and move the executable to
/usr/local/bin/, making it available system-wide.
Once installed, you can use the docker-container-manager command to manage your Docker containers. Below are the available commands and their descriptions.
To list all Docker containers, use the following command:
docker-container-manager listTo start a specific Docker container, use the following command:
docker-container-manager start <containerID>Replace <containerID> with the ID of the container you want to start.
To stop a specific Docker container, use the following command:
docker-container-manager stop <containerID>Replace <containerID> with the ID of the container you want to stop.
To view the logs of a specific Docker container, use the following command:
docker-container-manager logs <containerID>Replace <containerID> with the ID of the container you want to view logs for.
To get detailed information about a specific Docker container, use the following command:
docker-container-manager inspect <containerID>Replace <containerID> with the ID of the container you want to inspect.
To monitor the resource usage of a specific Docker container, use the following command:
docker-container-manager stats <containerID>Replace <containerID> with the ID of the container you want to monitor.
To uninstall Docker Container Manager, follow these steps:
-
Run the Uninstallation Script:
./uninstall.sh
The script will remove the executable from
/usr/local/bin/.
Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request. For major changes, please discuss your ideas in an issue before making any changes.
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature-name). - Make your changes and commit them (
git commit -m 'Add some feature'). - Push to the branch (
git push origin feature/your-feature-name). - Open a pull request.
This project is licensed under the MIT License. See the LICENSE file for more details.
Thank you for using Docker Container Manager! If you have any questions or need further assistance, feel free to reach out.
### Conclusion
This detailed `README.md` file provides users with clear instructions on how to install, use, and uninstall your Docker Container Manager tool. It also includes sections for contributing and licensing, making it easier for others to contribute to your project and understand its terms of use.