✨ Initial commit

.editorconfig

@@ -0,0 +1,8 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true

.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# These owners will be the default owners for everything in
+# the repo, unless a later match takes precedence:
+#
+# @bdsoha will be requested for review when someone opens a pull request.
+*           @bdsoha

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -0,0 +1,55 @@
+---
+name: 🐛 Bug Report
+description: Report an issue to help the project improve.
+title: 🐛 <title>
+labels:
+  - "type: bug 🐛"
+body:
+  - type: checkboxes
+    attributes:
+      label: Is there an existing issue for this?
+      description: Please search to see if an issue already exists for the bug you encountered.
+      options:
+        - label: I have searched the existing issues
+          required: true
+
+  - type: input
+    attributes:
+      label: Version
+      description: Docker image digest
+      placeholder: sha256:58025ebfabf03b54899829b7d20b1c9c3de3558f452edd033802e809a8c194b0
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Current Behavior
+      description: A concise description of what you're experiencing.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected Behavior
+      description: A concise description of what you expected to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps To Reproduce & Additional information
+      description: |
+        Steps to reproduce the behavior:
+
+        - Links
+        - References
+        - More context about the issue you are encountering!
+
+        Tip: You can attach images by dragging files into this area.
+      placeholder: |
+        1. In this environment...
+        1. With this config...
+        1. Run '...'
+        1. See error...
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/docs_request.yaml

@@ -0,0 +1,26 @@
+---
+name: 📚 Documentation Change
+description: Improvements or additions to documentation.
+title: 📚 <title>
+labels:
+  - "type: documentation 📚"
+body:
+  - type: checkboxes
+    attributes:
+      label: Is there an existing request for this change?
+      description: |
+        Please make sure a request does not already exists for the
+        documentation changes you're looking to implement.
+      options:
+        - label: I have searched the existing issues
+          required: true
+  - type: textarea
+    attributes:
+      label: Context for documentation change
+      description: Explain what led you to draft this issue.
+      placeholder: |
+        I noticed unclear explanation of build and install and encountered
+        a few issues while attempting it myself.
+        This could confuse other contributors.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -0,0 +1,32 @@
+---
+name: 🚀 Feature Request
+description: Request a new feature.
+title: 🚀 <title>
+labels:
+  - "type: feature request 🚀"
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: A clear and concise description of the feature you're interested in.
+      placeholder: Describe in a few lines your feature request.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Suggested Solution
+      description: |
+        Describe the solution you'd like.
+        A clear and concise description of what you want to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Additional Context
+      description: |
+        Add any other context about the problem here.
+    validations:
+      required: false

.github/workflows/build.yaml

@@ -0,0 +1,73 @@
+---
+name: 👷‍♂️ Build
+
+on:
+  push:
+    branches:
+      - main
+
+    tags:
+      - v*
+
+jobs:
+  lint:
+    name: 🧹 Lint
+    runs-on: ubuntu-latest
+    if: github.actor != 'renovate[bot]' && github.actor != 'renovate[bot]'
+    steps:
+      - name: 📁 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 🧹 Lint
+        uses: pre-commit/[email protected]
+
+  build:
+    name: 🐳 Docker Build
+    runs-on: ubuntu-latest
+    needs:
+      - lint
+
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: 📁 Checkout repository
+        uses: actions/checkout@v4
+
+      - uses: docker/setup-qemu-action@v3
+      - uses: docker/setup-buildx-action@v3
+
+      - name: 🔑 Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 📃 Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+          flavor: |
+            latest=false
+          tags: |
+            type=raw,value=latest,enable=${{ github.ref == 'refs/heads/main' }}
+            type=ref,event=pr,prefix=pr-
+            type=semver,pattern=v{{version}}
+            type=semver,pattern=v{{major}}.{{minor}}
+
+      - name: 🐳 Docker Build & Push
+        uses: docker/build-push-action@v6
+        id: docker_build
+        env:
+          DOCKER_BUILD_NO_SUMMARY: true
+        with:
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          context: .
+          labels: ${{ steps.meta.outputs.labels }}
+          push: true
+          provenance: false
+          tags: ${{ steps.meta.outputs.tags }}

.pre-commit-config.yaml

@@ -0,0 +1,30 @@
+---
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: check-added-large-files
+        args:
+          - --maxkb=300
+      - id: check-json
+      - id: check-toml
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+      - id: trailing-whitespace
+
+  - repo: https://github.com/adrienverge/yamllint
+    rev: v1.35.1
+    hooks:
+      - id: yamllint
+        args:
+          - --config-file
+          - src/home/.config/yamllint/config
+
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.39.0
+    hooks:
+      - id: markdownlint
+        args:
+          - --config
+          - src/home/.config/markdownlint/config

Dockerfile

@@ -0,0 +1,93 @@
+ARG tag=12
+
+################################## Temp Layer ##################################
+
+FROM debian:${tag} AS temp
+
+RUN mkdir -p /etc/apt/keyrings
+
+### Install helper requirements
+RUN apt-get update \
+  && apt-get satisfy -y --no-install-recommends \
+    "ca-certificates (>=20230311)" \
+    "curl (>=7.88)" \
+    "gnupg (>=2.2)" \
+    "unzip (>=6.0)" \
+  && rm -rf /var/lib/apt/lists/*
+
+### Add non-standard repository keys
+RUN --mount=src=src,dst=/build \
+  /build/add-gpg-keyrings.sh /build/extra.gpg.txt \
+  && chmod a+r /etc/apt/keyrings/*.gpg
+
+################################## Base Layer ##################################
+
+FROM debian:${tag} AS base
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+
+ENV LANG=en_US.UTF-8
+
+COPY src/rootfs /
+COPY --from=temp /etc/apt/keyrings /etc/apt/keyrings
+
+### Add application user
+RUN adduser \
+  --disabled-password \
+  --gecos '' \
+  --uid 1000 \
+  kloud
+
+### Install packages
+RUN --mount=src=src,dst=/build \
+  apt-get update \
+  && apt-get satisfy -y --no-install-recommends \
+    "ca-certificates (>=20230311)" \
+  && apt-get update \
+  && apt-get satisfy -y --no-install-recommends $(cat /build/packages.apt) \
+  && rm -rf \
+    /var/lib/apt/lists/* \
+    /usr/lib/python3.11/EXTERNALLY-MANAGED \
+  && locale-gen \
+  && ln -fs "$(which python3)" /usr/bin/python
+
+############################### Dependency Layer ###############################
+
+FROM temp AS deps
+WORKDIR /usr/local/bin
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+ARG TARGETARCH
+
+# renovate: source=github-releases dep=google/go-containerregistry
+ARG crane_version=0.20.0
+
+RUN case ${TARGETARCH} in "arm64") amr64 ;; "amd64") file=x86_64 ;; esac \
+  && curl -fsSL "https://github.com/google/go-containerregistry/releases/download/v${crane_version}/go-containerregistry_Linux_${file}.tar.gz" \
+    | tar -xzf - \
+  && curl -fsSL https://mirror.openshift.com/pub/openshift-v4/x86_64/clients/ocp/4.9.9/openshift-client-linux.tar.gz \
+    | tar -xzf - -C /tmp \
+  && cp /tmp/oc .
+
+RUN chown -R root:root /usr/local/bin \
+  && chmod -R 755 /usr/local/bin
+
+############################### Application layer ##############################
+
+FROM base
+USER kloud
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+WORKDIR /workspace
+
+ENV USER=kloud
+ENV PATH=${PATH}:/home/kloud/.local/bin
+
+### Install user packages & extensions
+RUN --mount=src=src,dst=/build \
+  helm plugin install https://github.com/databus23/helm-diff \
+  && pip install --no-cache-dir -r /build/requirements.txt \
+  && pip cache purge \
+  && ansible-galaxy install -r /build/requirements.yaml \
+  && rm -rf \
+    /home/kloud/.ansible/galaxy_cache \
+    /home/kloud/.cache/helm
+
+ENTRYPOINT ["ansible-playbook"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 KloudKIT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,14 @@
+# Ansible Controller
+
+> 🎮 Ansible controller: your configurations can stay home
+
+[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square&link=https://github.com/kloudkit/ansible-controller?tab=MIT-1-ov-file#MIT-1-ov-file)](https://github.com/kloudkit/ansible-controller?tab=MIT-1-ov-file#MIT-1-ov-file)
+
+## Documentation
+
+TBD
+
+## License
+
+This project is licensed under the
+[**MIT License**](https://github.com/kloudkit/ansible-controller?tab=MIT-1-ov-file#MIT-1-ov-file)

renovate.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended",
+    ":disableRateLimiting"
+  ],
+  "assignees": [ "bdsoha" ],
+  "labels": [ "type: dependency 🔼" ],
+  "schedule": [ "every weekend" ],
+  "dependencyDashboard": true,
+  "dependencyDashboardTitle": "🤖 Renovate Dashboard",
+  "commitMessageAction": "🔼 Bump",
+  "regexManagers": [
+    {
+      "fileMatch": [ "^Dockerfile$" ],
+      "matchStrings": [
+        "# renovate: source=(?<datasource>.*?) dep=(?<depName>.*?)( versioning=(?<versioning>.*?))?\\nARG.*=(?<currentValue>.*)\\n"
+      ],
+      "versioningTemplate": "{{#if versioning}}{{{versioning}}}{{else}}semver{{/if}}"
+    }
+  ]
+}

src/add-gpg-keyrings.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+while IFS= read -r line; do
+  read -r name url <<< "${line}"
+
+  curl -fsSL "https://${url}" \
+    | gpg --dearmor -o "/etc/apt/keyrings/${name}.gpg"
+done < "${1}"