From e1ff1af002973c764369837a68394d7e968d2f4e Mon Sep 17 00:00:00 2001 From: James Kunstle <52969093+JamesKunstle@users.noreply.github.com> Date: Mon, 1 Apr 2024 23:00:27 -0400 Subject: [PATCH 1/3] Update README.md --- README.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index cb14d3c1..9126572e 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# 8Knot (Explorer) +# 8Knot ![Pre-Commit](https://github.com/JamesKunstle/explorer/actions/workflows/pre-commit.yml/badge.svg) ![Build-Push](https://github.com/JamesKunstle/explorer/actions/workflows/build-push-quay.yml/badge.svg) @@ -219,9 +219,18 @@ docker && docker compose || docker-compose (above just runs docker and docker-compose and checks if both work) -NOTE: `podman-compose` has been generally verified to work as well, but our preference is `docker compose` -`podman-compose` doesn't support the `--scale` flag as we would expect so we don't use it for our own -development applications, but the application is built to work with the minimum number of containers. "your mileage my vary". +NOTE: As of 3/29/24 we recommend using `Podman` and `Podman Desktop` instead of `Docker` and `Docker Desktop`. It will be our default development environment going forward. +There are many guides to transitioning from `Docker` (Desktop) to `Podman` (Desktop), but here's a rough outline of our "golden path." + +1. Uninstall `Docker Desktop`. This will require a GUI uninstall and looking through your apps + filesystem for remnants. +2. Install `Podman` and `Podman Desktop`. You'll also explicitly have to provision a `Podman Machine` if you're on a Mac. +3. Enable the "Docker compatibility add-on" available in `Podman Desktop`. This will route traffic headed for a Docker machine to the running Podman machine. (Under the hood, this points Podman at the Docker socket." +4. Install `docker-compose`. This is a standalone, open source tool that `Podman Compose` delegates compose responsibilities to. + +At this point, the `Podman` docs claim that one should have moved over to `Podman` as a drop-in replacement for `Docker`. However, here are two steps that we noticed were necessary in some cases. + +1. In `$HOME/.docker/config.json` replace "credsStore" with "credStore" (minus an 's') to solve registry credentialing problems. +2. Set `export DOCKER_HOST=` to the `Podman machine`'s socket on your system, which you can find in the `Resources` tab of `Podman Desktop`. The path starts with `unix://`. ### Build and Run From 0d5d8611ec1f7fc8aa9b688f51556d73637d1a74 Mon Sep 17 00:00:00 2001 From: cdolfi Date: Wed, 27 Mar 2024 16:49:49 -0400 Subject: [PATCH 2/3] small title fix --- .wordlist-md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.wordlist-md b/.wordlist-md index 86bf4a46..602d9642 100644 --- a/.wordlist-md +++ b/.wordlist-md @@ -72,3 +72,7 @@ Docker's data-center OAuth postgres +Podman +filesystem +credsStore +credStore From e0d2f9cd55c3c873930cc4ca0d8bed54dfb4efa0 Mon Sep 17 00:00:00 2001 From: James Kunstle Date: Thu, 4 Apr 2024 16:48:50 -0400 Subject: [PATCH 3/3] pre-commit fix Signed-off-by: James Kunstle --- .wordlist-md | 4 ++++ README.md | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/.wordlist-md b/.wordlist-md index 602d9642..2c407053 100644 --- a/.wordlist-md +++ b/.wordlist-md @@ -76,3 +76,7 @@ Podman filesystem credsStore credStore +filesystem +Podman +credsStore +credStore diff --git a/README.md b/README.md index 9126572e..0102af7d 100644 --- a/README.md +++ b/README.md @@ -230,7 +230,7 @@ There are many guides to transitioning from `Docker` (Desktop) to `Podman` (Desk At this point, the `Podman` docs claim that one should have moved over to `Podman` as a drop-in replacement for `Docker`. However, here are two steps that we noticed were necessary in some cases. 1. In `$HOME/.docker/config.json` replace "credsStore" with "credStore" (minus an 's') to solve registry credentialing problems. -2. Set `export DOCKER_HOST=` to the `Podman machine`'s socket on your system, which you can find in the `Resources` tab of `Podman Desktop`. The path starts with `unix://`. +2. Set `export DOCKER_HOST=` to the `Podman machine`'s socket on your system, which you can find in the `Resources` tab of `Podman Desktop`. The path starts with `unix://`. ### Build and Run