Files
James E. Blair 76f7d210de Switch quickstart to docker compose v2
We want to use podman to run our containers, but the podman-compose
tool has been problematic to use in OpenDev and has also caused
some confusion for users.  It also seems the podman project is
favoring declaring systems using k8s syntax rather than compose,
which is putting the podman-compose tool future in question.

This change updates the quickstart to use "docker compose" (ie,
docker-compose v2) instead of podman-compose.

Because we want to continue using speculative container testing
which does not work for quay.io images when using docker, we will
use the podman backend with docker compose.  This is what we
are moving toward in OpenDev.  We hope that it is the best of both
worlds.

Users likely don't need such a complex setup, so we will adjust
the documentation to use "docker compose" but not mention anything
about podman.  That will remain a test implementation detail,
at least as long as we think they are sufficiently compatible that
we can get away with testing something slightly different than
our instructions.

This switches to packaged git-review for simplicity because
pip install does not work in noble.

Fedora and OpenSuse installation instructions are similarly updated.

Red Hat / CentOS instructions are removed because this author does
not have a way to verify package names.  Their return by someone
knowledgable with that is welcome.

Change-Id: I238f6db178af86fa7203203993c90bd8d1371712
Depends-On: https://review.opendev.org/923083
Depends-On: https://review.opendev.org/925916
Co-Authored-By: Clark Boylan <clark.boylan@gmail.com>
2025-10-31 07:43:57 -07:00

31 lines
892 B
YAML

- hosts: all
roles:
- ensure-pip
- ensure-docker
- role: ensure-podman
ensure_podman_socket: true
- use-buildset-registry
tasks:
# docker-compose-v2 depends on the docker service. Disable it to
# ensure we're not accidentally using the docker daemon.
- name: Disable docker daemon service
become: true
service:
name: docker
state: stopped
enabled: false
- name: Disable docker socket service
become: true
service:
name: docker.socket
state: stopped
enabled: false
- name: Start buildx builder
# This may not be necessary under a normal docker install
# https://github.com/docker/buildx/issues/344
shell: |
echo "FROM scratch" | docker buildx build - || true
environment:
DOCKER_HOST: unix:///run/podman/podman.sock
become: true