https://github.com/kineticcafe/docker-ansible
Run Ansible without installing it from docker
https://github.com/kineticcafe/docker-ansible
ansible docker-image
Last synced: 8 months ago
JSON representation
Run Ansible without installing it from docker
- Host: GitHub
- URL: https://github.com/kineticcafe/docker-ansible
- Owner: KineticCafe
- License: other
- Created: 2021-05-21T20:29:58.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2025-01-19T03:15:39.000Z (over 1 year ago)
- Last Synced: 2025-01-29T11:46:55.658Z (over 1 year ago)
- Topics: ansible, docker-image
- Language: Shell
- Homepage:
- Size: 105 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.md
Awesome Lists containing this project
README
# [ghcr.io/]kineticcafe/ansible: Ansible in Docker
> [!IMPORTANT]
>
> This image will no longer receive updates and the repo is being archived as we
> no longer use Ansible. I recommend forking this repo if you wish to maintain a
> similar image for your organization as the architecture and actions work very
> well.
>
> Kinetic Cafe open source team
This is a simple Docker container that contains [Ansible][Ansible]. It has been
created so that it's easier to work with `ansible-playbook` without going
through the effort of installing it on various systems.
The image is based on Debian Bookworm (slim) and includes:
- Ansible 10.5.0
- Python 3.13
These images can be pulled either from Docker Hub (`kineticcafe/ansible:6.0`) or
the GitHub Container Registry (`ghcr.io/kineticcafe/ansible:6.0`).
## Support
Tests have been made on Ubuntu 18 and macOS 13 (Apple Silicon).
Because of recent changes to cryptographic packages in Python, support for
`linux/arm/v7` has been dropped.
## `kineticcafe-ansible` script Commands
The `kineticcafe-ansible` script is recommended for running everything as it
manages environment variable configuration for each run. The
`kineticcafe-ansible` script will pull from `ghcr.io/kineticcafe/ansible:6.0` by
default; this can be overridden by using `$IMAGE`:
```sh
$ IMAGE=kineticcafe/ansible:latest ./kineticcafe-ansible --version
```
### Installing `kineticcafe-ansible`
`kineticcafe-ansible` can be installed with symlinks using the `install` script:
```sh
curl -sSL --fail \
https://raw.githubusercontent.com/KineticCafe/docker-ansible/main/install |
bash -s -- ~/.local/bin
```
Replace `~/.local/bin` with your preferred binary directory.
By default, it will download `kineticcafe-ansible` from GitHub and install it in
the provided `TARGET` and make symbolic links for the following Ansible
commands: `ansible`, `ansible-community`, `ansible-config`,
`ansible-connection`, `ansible-console`, `ansible-doc`, `ansible-galaxy`,
`ansible-inventory`, `ansible-playbook`, `ansible-pull`, `ansible-test`, and
`ansible-vault`. Symbolic link creation will not overwrite files or symbolic
links to locations _other_ than `TARGET/kineticcafe-ansible`.
`--no-symlinks` (`-S`) may be specified to skip symbolic link creation entirely.
`--force` (`-f`) may be specified to install `kineticcafe-ansible` even if it
already exists, and to overwrite files and non-`TARGET/kineticcafe-ansible`
symbolic links.
`--verbose` (`-v`) will turn on trace output of commands.
## Maintenance/Upgrade Instructions
1. Install [pdm][pdm]: `pipx install pdm`.
2. Edit the `Dockerfile` to update the Python version, if required.
3. Edit the `pyproject.toml` to change the dependencies and update the
`project.version`.
4. Run `pdm update`.
5. Update `CHANGELOG.md` and `README.md` as required.
[ansible]: https://www.ansible.com/community
[pdm]: https://github.com/pdm-project/pdm