streamline package naming

2026-07-29 13:07:34 +02:00
parent 1ba1c2a32a
commit 7e703c93b1
100 changed files with 141 additions and 139 deletions
@@ -0,0 +1,60 @@
+# docker
+
+**Install Docker and tools**
+
+## Purpose
+
+This cube installs Docker Engine, Docker Compose, and popular Docker management tools to enable containerized application deployment and management.
+
+## What is Docker?
+
+Docker is a platform for developing, shipping, and running applications in containers. Containers package an application with all its dependencies, ensuring it runs consistently across different environments.
+
+Key benefits:
+- **Isolation**: Each container runs independently with its own filesystem, network, and processes
+- **Portability**: Containers run the same way on any system that supports Docker
+- **Efficiency**: Containers share the host OS kernel, making them lighter than virtual machines
+- **Scalability**: Easily deploy and scale containerized applications
+
+## What This Cube Does
+
+1. **Adds Docker's official repository**
+   - Downloads and installs Docker's GPG key
+   - Configures APT to use Docker's official package repository
+
+2. **Installs Docker components**
+   - `docker-ce` - Docker Community Edition engine
+   - `docker-ce-cli` - Command-line interface for Docker
+   - `containerd.io` - Container runtime
+   - `docker-buildx-plugin` - Extended build capabilities with BuildKit
+   - `docker-compose-plugin` - Tool for defining multi-container applications
+
+3. **Installs management tools**
+   - **lazydocker** - Terminal UI for Docker and Docker Compose management
+   - **docker-ctop** - Container metrics and monitoring (top-like interface for containers)
+
+## Configuration
+
+This cube currently has no configurable parameters.
+
+## Dependencies
+
+None - this cube can run standalone.
+
+## Post-Installation
+
+After deployment:
+- Add users to the `docker` group to run Docker without sudo: `sudo usermod -aG docker username`
+- Start using Docker: `docker run hello-world`
+- Use lazydocker for easy management: `lazydocker`
+- Monitor containers: `ctop`
+
+## Notes
+
+The Docker daemon starts automatically on boot. You can manage it with systemd:
+- Check status: `sudo systemctl status docker`
+- Restart: `sudo systemctl restart docker`
+
+## Additional Resources
+
+- [Installation tutorial Ubuntu 24.04](https://www.cherryservers.com/blog/install-docker-ubuntu)
@@ -0,0 +1,75 @@
+from pyinfra import host
+from pyinfra.operations import server, apt
+
+
+DISTRO = host.data.DISTRO
+
+server.shell(
+    commands=[
+        "install -m 0755 -d /etc/apt/keyrings",
+        f"curl -fsSL https://download.docker.com/linux/{DISTRO}/gpg | gpg --dearmor --yes -o /etc/apt/keyrings/docker.gpg",
+        "sudo chmod a+r /etc/apt/keyrings/docker.gpg",
+        f""" echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/{DISTRO} "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" |   sudo tee /etc/apt/sources.list.d/docker.list > /dev/null """,
+        "apt update"
+    ],
+    _sudo=True
+)
+
+apt.packages(
+    packages=[
+        "docker-ce",
+        "docker-ce-cli",
+        "containerd.io",
+        "docker-buildx-plugin",
+        "docker-compose-plugin",
+    ],
+    present=True,
+    _sudo=True
+)
+
+
+server.shell(
+    name="Install Lazydocker system-wide",
+    commands=[
+        'export DIR=/usr/local/bin && curl -fsSL https://raw.githubusercontent.com/jesseduffield/lazydocker/master/scripts/install_update_linux.sh | bash -s --'
+    ],
+    _sudo=True
+)
+
+# Install required packages
+apt.packages(
+    name="Install required dependencies",
+    packages=["ca-certificates", "curl", "gnupg", "lsb-release"],
+    update=True,
+    _sudo=True
+)
+
+# Download and store the GPG key
+server.shell(
+    name="Download and store Azlux repo GPG key",
+    commands=[
+        "curl -fsSL https://azlux.fr/repo.gpg.key | gpg --dearmor --yes -o /usr/share/keyrings/azlux-archive-keyring.gpg"
+    ],
+    _sudo=True
+)
+
+# Add the repository to sources.list
+server.shell(
+    name="Add Azlux repository to APT sources",
+    commands=[
+        """ echo "deb [arch="$(dpkg --print-architecture)" signed-by=/usr/share/keyrings/azlux-archive-keyring.gpg] http://packages.azlux.fr/debian bookworm main" | sudo tee /etc/apt/sources.list.d/azlux.list > /dev/null """,
+    ],
+    _sudo=True
+)
+
+# Update APT and install docker-ctop
+apt.update(
+    name="Update package lists",
+    _sudo=True
+)
+
+apt.packages(
+    name="Install docker-ctop",
+    packages=["docker-ctop"],
+    _sudo=True
+)
@@ -0,0 +1,11 @@
+import { Manifest } from '@bitsquare/nopy-cubes';
+import { z } from 'zod';
+
+export default Manifest({
+  id: 'runtime:docker',
+  name: 'Install docker and tools',
+  dependencies: () => [],
+  schema: z.object({
+    DISTRO: z.enum(['ubuntu', 'debian']).default('ubuntu').describe('Linux distribution to target'),
+  }),
+});