de-it-krachten/ansible-playbooks-docker_build
1
0
Fork 0
mirror of https://github.com/de-it-krachten/ansible-playbooks-docker_build synced 2026-05-14 11:41:38 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
8 commits 2 branches 1 tag 36 KiB
Find a file
Exact
semantic-release-bot a6e9b875e7 chore(release): 1.0.0 [skip ci] 
# 1.0.0 (2022-07-14)

### Features

* Initial release ([2a2b647](2a2b647c33))
2022-07-14 16:49:47 +00:00
.github/workflows Activate release phase of CI 2022-07-14 18:47:47 +02:00
roles Initial commit 2022-07-14 16:07:29 +02:00
.ansible-lint Initial commit 2022-07-14 16:07:29 +02:00
.cicd Activate release phase of CI 2022-07-14 18:47:47 +02:00
.cicd.overwrite Activate CI 2022-07-14 18:34:37 +02:00
.gitignore Initial commit 2022-07-14 16:07:29 +02:00
.releaserc.yml Activate release phase of CI 2022-07-14 18:47:47 +02:00
.yamllint Activate CI 2022-07-14 18:34:37 +02:00
CHANGELOG.md chore(release): 1.0.0 [skip ci] 2022-07-14 16:49:47 +00:00
docker_build.yml Initial commit 2022-07-14 16:07:29 +02:00
README.md Add README 2022-07-14 16:36:46 +02:00

README.md

Docker build tools

The docker build tools will make it easy to create a docker image using Ansible. This way, you do not have to put all the logic into the Dockerfile but can do it via Ansible.

How does it work:

  1. A docker image is created using the Dockerfile template within your project.
  2. A Docker container is spun-up from this newly created image.
  3. The running container is altered by executing the Ansible playbooks against this container.
  4. When the playbook is finished, a final image is created from the running container.

Installation

All tools required are within an Ansible role.
To install the tools onto your laptop or CI/CD server, execute the following :

  • Clone the project
git clone https://github.com/de-it-krachten/ansible-playbooks-docker_build.git
  • Switch to the newly cloned repository as working directory
cd ansible-playbooks-docker_build
  • Retrieve all required Ansible roles
ansible-galaxy install -r roles/requirements.yml -p roles/
  • Install all scripts & templates onto your system
ansible-playbook docker_build.yml -i localhost, -c local -b

Initialize

  • Create a new directory and make it the working directory

  • Initialize that directory with templates

/usr/local/bin/docker-init.sh

  • Edit all container setting in file 'docker-settings.yml'

  • Edit 'Dockerfile.j2' to reflect all that you do not want or cannot do via Ansible in the next phase.

  • Edit 'build-custom.yml' with any changes using Ansible

  • Edit requirements.yml to include all roles your 'build-custom.yml' requires

Test image creation process by staring the build

/usr/local/bin/docker-build.sh

Final image can be push to Docker registry

/usr/local/bin/docker-build.sh -B -p