implemented compose by url, parse, local yaml.

docs/upstream-sources.yml

@@ -0,0 +1,553 @@
+---
+version: 1
+policy:
+  vendor_method: copied_snapshots
+  vendor_root: roles
+  deployed_from: role_templates
+  notes:
+    - Upstream files are reference snapshots only and are not deployed directly.
+    - "Use compose_paths: [] when upstream documents Compose in README files only."
+    - "Use compose_urls: [] for direct raw HTTP Compose YAML fallback URLs."
+    - "Use role-level local_compose_file as a repo-local fallback Compose reference."
+    - "status: verify means the source mapping must be checked before pinning."
+
+sources:
+  alloy:
+    role: alloy
+    vendor_dir: roles/alloy/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/grafana/alloy.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  arr:
+    role: arr
+    vendor_dir: roles/arr/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: prowlarr-container
+        url: https://github.com/linuxserver/docker-prowlarr.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+      - purpose: sonarr-container
+        url: https://github.com/linuxserver/docker-sonarr.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+      - purpose: radarr-container
+        url: https://github.com/linuxserver/docker-radarr.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+      - purpose: lidarr-container
+        url: https://github.com/linuxserver/docker-lidarr.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+      - purpose: bazarr-container
+        url: https://github.com/linuxserver/docker-bazarr.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  authentik:
+    role: authentik
+    vendor_dir: roles/authentik/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/goauthentik/authentik.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: [https://docs.goauthentik.io/compose.yml]
+
+  authentik_ldap:
+    role: authentik_ldap
+    vendor_dir: roles/authentik_ldap/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/goauthentik/authentik.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: [https://docs.goauthentik.io/add-secure-apps/outposts/manual-deploy-docker-compose/]
+
+  authentik_proxy:
+    role: authentik_proxy
+    vendor_dir: roles/authentik_proxy/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/goauthentik/authentik.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: [https://docs.goauthentik.io/add-secure-apps/outposts/manual-deploy-docker-compose/]
+
+  authentik_rac:
+    role: authentik_rac
+    vendor_dir: roles/authentik_rac/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/goauthentik/authentik.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: [https://docs.goauthentik.io/add-secure-apps/outposts/manual-deploy-docker-compose/]
+
+  cleanuparr:
+    role: cleanuparr
+    vendor_dir: roles/cleanuparr/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/cleanuparr/cleanuparr.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  code_server:
+    role: code_server
+    vendor_dir: roles/code_server/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/linuxserver/docker-code-server.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  filebrowser_quantum:
+    role: filebrowser_quantum
+    status: verify
+    vendor_dir: roles/filebrowser_quantum/upstream
+    local_compose_file: ""
+    notes:
+      - Verify upstream repository for the gtstef/filebrowser image before pinning.
+    repositories:
+      - purpose: container
+        url: https://github.com/gtsteffaniak/filebrowser.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: [https://filebrowserquantum.com/en/docs/user-guides/other/standalone/]
+
+  fiveetools:
+    role: fiveetools
+    status: verify
+    vendor_dir: roles/fiveetools/upstream
+    local_compose_file: ""
+    notes:
+      - Verify upstream repository for the jafner/5etools image before pinning.
+    repositories:
+      - purpose: container
+        url: https://github.com/Jafner/5etools-docker.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: [docker-compose.yml]
+        compose_urls: []
+
+  flaresolverr:
+    role: flaresolverr
+    vendor_dir: roles/flaresolverr/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/FlareSolverr/FlareSolverr.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: [docker-compose.yml]
+        compose_urls: []
+
+  gitea:
+    role: gitea
+    vendor_dir: roles/gitea/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/go-gitea/gitea.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: [https://docs.gitea.com/installation/install-with-docker-rootless]
+
+  gitea_act_runner:
+    role: gitea_act_runner
+    vendor_dir: roles/gitea_act_runner/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://gitea.com/gitea/act_runner.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: [https://docs.gitea.com/usage/actions/act-runner#start-the-runner-using-docker-compose]
+
+  grafana:
+    role: grafana
+    vendor_dir: roles/grafana/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/grafana/grafana.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: [] # Host own, all examples are bad
+
+  grafana_renderer:
+    role: grafana_renderer
+    vendor_dir: roles/grafana_renderer/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/grafana/grafana-image-renderer.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  homarr:
+    role: homarr
+    vendor_dir: roles/homarr/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/homarr-labs/homarr.git
+        ref: dev
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  immich:
+    role: immich
+    vendor_dir: roles/immich/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/immich-app/immich.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: [docker/docker-compose.yml]
+        compose_urls: []
+
+  ipv6nat:
+    role: ipv6nat
+    vendor_dir: roles/ipv6nat/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/robbertkl/docker-ipv6nat.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  jellyfin:
+    role: jellyfin
+    vendor_dir: roles/jellyfin/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/linuxserver/docker-jellyfin.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+      - purpose: application
+        url: https://github.com/jellyfin/jellyfin.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  jellyseerr:
+    role: jellyseerr
+    vendor_dir: roles/jellyseerr/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/Fallenbagel/jellyseerr.git
+        ref: develop
+        readme_paths: [README.md]
+        compose_paths: [docker-compose.yml]
+        compose_urls: []
+
+  kavita:
+    role: kavita
+    vendor_dir: roles/kavita/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/linuxserver/docker-kavita.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  kiwix_serve:
+    role: kiwix_serve
+    vendor_dir: roles/kiwix_serve/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/kiwix/kiwix-tools.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  loki:
+    role: loki
+    vendor_dir: roles/loki/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/grafana/loki.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: [production/docker-compose.yaml]
+        compose_urls: []
+
+  nginx_content:
+    role: nginx_content
+    vendor_dir: roles/nginx_content/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/nginx/nginx.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  ntfy:
+    role: ntfy
+    vendor_dir: roles/ntfy/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/binwiederhier/ntfy.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: [docker-compose.yml]
+        compose_urls: []
+
+  ocis:
+    role: ocis
+    vendor_dir: roles/ocis/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/owncloud/ocis.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: [deployments/examples/ocis_full/docker-compose.yml]
+        compose_urls: []
+
+  paperless_ngx:
+    role: paperless_ngx
+    vendor_dir: roles/paperless_ngx/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/paperless-ngx/paperless-ngx.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: [docker/compose/docker-compose.postgres.yml]
+        compose_urls: []
+
+  pelican_panel:
+    role: pelican_panel
+    vendor_dir: roles/pelican_panel/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/pelican-dev/panel.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: [compose-full-stack.yml]
+        compose_urls: []
+
+  php_fpm:
+    role: php_fpm
+    vendor_dir: roles/php_fpm/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/docker-library/php.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  pinchflat:
+    role: pinchflat
+    vendor_dir: roles/pinchflat/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/kieraneglin/pinchflat.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  postgres:
+    role: postgres
+    vendor_dir: roles/postgres/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/docker-library/postgres.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  prometheus:
+    role: prometheus
+    vendor_dir: roles/prometheus/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/prometheus/prometheus.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: [documentation/examples/prometheus.yml]
+        compose_urls: []
+
+  pterodactyl:
+    role: pterodactyl
+    vendor_dir: roles/pterodactyl/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/pterodactyl/panel.git
+        ref: 1.0-develop
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  qbittorrent:
+    role: qbittorrent
+    vendor_dir: roles/qbittorrent/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/linuxserver/docker-qbittorrent.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  requarks:
+    role: requarks
+    vendor_dir: roles/requarks/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/requarks/wiki.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  syncthing:
+    role: syncthing
+    vendor_dir: roles/syncthing/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/linuxserver/docker-syncthing.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  traefik:
+    role: traefik
+    vendor_dir: roles/traefik/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/traefik/traefik.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  transmission:
+    role: transmission
+    vendor_dir: roles/transmission/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: container
+        url: https://github.com/linuxserver/docker-transmission.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  uptime_kuma:
+    role: uptime_kuma
+    vendor_dir: roles/uptime_kuma/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/louislam/uptime-kuma.git
+        ref: master
+        readme_paths: [README.md]
+        compose_paths: [compose.yaml]
+        compose_urls: []
+
+  valkey:
+    role: valkey
+    vendor_dir: roles/valkey/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/valkey-io/valkey.git
+        ref: unstable
+        readme_paths: [README.md]
+        compose_paths: []
+        compose_urls: []
+
+  vaultwarden:
+    role: vaultwarden
+    vendor_dir: roles/vaultwarden/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/dani-garcia/vaultwarden.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: [docker/docker-compose.yml]
+        compose_urls: []
+
+  wizarr:
+    role: wizarr
+    vendor_dir: roles/wizarr/upstream
+    local_compose_file: ""
+    repositories:
+      - purpose: application
+        url: https://github.com/Wizarrrr/wizarr.git
+        ref: main
+        readme_paths: [README.md]
+        compose_paths: [docker-compose.yml]
+        compose_urls: []