Skip to content

Commit fb0c097

Browse files
committed
Add Podman support
Adds Podman as an alternative to Docker for developers who cannot easily use Docker. Podman is a daemonless container engine with Docker-compatible CLI and compose functionality. Key features: - Two-container architecture: development shell and dedicated test container - Automated setup script with init, test, shell, status, logs, clean commands - Full test suite compatibility with proper network configuration - Rootless mode by default - Comprehensive documentation with troubleshooting guide - CI parity: tests run identically locally and in GitHub Actions The test container uses hostname 'http-server' for network tests, ensuring all HTTP/network tests pass correctly.
1 parent 568d073 commit fb0c097

File tree

5 files changed

+2192
-0
lines changed

5 files changed

+2192
-0
lines changed

.gitignore

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,3 +16,11 @@
1616
/tmp
1717
nohup.out
1818
vendor/
19+
20+
# Podman-specific
21+
.podman-machine-*
22+
podman-compose.override.yml
23+
.env.podman
24+
25+
# VS Code + Podman local settings
26+
.vscode/settings.local.json

README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -954,6 +954,24 @@ $ git clone https://github.com/Shopify/semian.git
954954
$ cd semian
955955
```
956956

957+
## Alternative: Using Podman
958+
959+
If you prefer Podman over Docker, see our [Podman setup guide](docs/PODMAN.md).
960+
961+
Quick start with Podman:
962+
```bash
963+
# Initialize everything
964+
./scripts/podman-setup.sh init
965+
966+
# Run tests
967+
./scripts/podman-setup.sh test
968+
969+
# Get a development shell
970+
./scripts/podman-setup.sh shell
971+
```
972+
973+
The Podman setup provides the same functionality as the Docker setup with full backward compatibility.
974+
957975
## Visual Studio Code
958976

959977
- Open semian in vscode

0 commit comments

Comments
 (0)