Docker-Werkzeuge
Starting with version 19.1, EGroupware uses Docker in a standard package installation. Details are described here:
https://help.egroupware.org/t/de-docker-in-egroupware-19-1/73796
With the 17.1 it was already possible to install Collabora Online based on Docker:
In this article we would like to document various tools for managing the Docker installation. This is divided into graphical (Web + command line) tools and command line commands.
At the end of this article we describe how to solve problems or perform maintenance.
The explanations are continuously updated and are certainly never complete!
Graphic tools
Portainer is an administration tool with a web interface:
It is installed itself as a container. It only needs two commands:
Installation
The range of functions is large and constantly growing:
-
Manage Docker-Images - pull, delete, create
-
Manage containers - start, stop, exit, restart, pause, resume, remove, create
-
Manage networks - add, remove, edit
-
Managing volumes - adding, removing, managing permissions
-
Viewing logs
-
Quickly deploy applications from app templates:
And what else Docker Hub gives away so…
https://hub.docker.com/search?q=&type=image
https://catalog.redhat.com/software/containers/explore/
Dockly is a simple ASCII tool that can be executed directly in the terminal:
Installation:
The functions are manageable (status 11.2019):
- Status of the containers
- Information about the container
- Show logs of containers and services
- open shell of a container
- Restart container
- Stop container
- various statistics/states
So Dockly is a good tool to get an overview and view the logs. Not started it doesn’t need any resources and is also usable on the command line (remotely, via ssh).
Links:
https://www.ostechnix.com/dockly-manage-docker-containers-from-terminal/
Command line commands
docker
Command reference:
https://docs.docker.com/engine/reference/commandline/docker/
docker ps
Lists the containers with some information. To quickly check whether containers are running (or not)
docker ps -a
Lists not only the running but also the stopped containers.
docker container ls -a
Shows all running containers, the parameter -a also shows all currently not running containers. This command replaces docker ps
, which still works.
docker system prune -a
Deletes old and non-running containers.
This may be necessary after manual updates of the containers.
The automatic update via watchtower (in a standard installation) automatically deletes the outdated containers.
docker exec -it egroupware bash
Enter the container egroupware.
Changes in the container are discarded by an update or recreation of the container!
docker network inspect
Lists the Docker network with the addresses of the containers
docker-compose restart
Restarts all containers listed in the Docker Compose configuration file (docker-compose.yml + docker-compose.override.yml). It is best/easiest to start from the respective directory.
System
Webserver-Log
The web server of EGroupware is run in the container egroupware-nginx
. The log can be read out with a simple script:
/etc/egroupware-docker/egroupware-logs.sh
How-Tos
Manual (container) update in a Docker installation
Further links
For questions, suggestions etc. please create your own topic in the forum and refer to this article.