# 最简单的迁移方式 — 设置别名
alias docker=podman
alias docker-compose=podman-compose

# 永久生效
echo 'alias docker=podman' >> ~/.bashrc
echo 'alias docker-compose=podman-compose' >> ~/.bashrc
source ~/.bashrc

# 验证
docker run --rm alpine echo "Hello from Docker... I mean Podman!"

# 用户级 Socket（Rootless）
systemctl --user enable --now podman.socket

# 验证 Socket
ls /run/user/$(id -u)/podman/podman.sock

# 设置 DOCKER_HOST 环境变量
export DOCKER_HOST=unix:///run/user/$(id -u)/podman/podman.sock

# 或创建软链接
ln -s /run/user/$(id -u)/podman/podman.sock /var/run/docker.sock
# ⚠️ Rootless 用户可能需要 sudo

# 测试 API
curl -s --unix-socket /run/user/$(id -u)/podman/podman.sock http://localhost/v1.41/info | python3 -m json.tool | head

# 启用系统级 podman.socket
sudo systemctl enable --now podman.socket

# 查看 Socket
ls /run/podman/podman.sock

# 创建 docker.sock 兼容
sudo ln -sf /run/podman/podman.sock /var/run/docker.sock

# 现在 Docker SDK 可以正常使用
export DOCKER_HOST=unix:///run/podman/podman.sock

# 无需修改代码，直接使用 Docker SDK
import docker

# 连接到 Podman Socket
client = docker.DockerClient(base_url='unix:///run/user/1000/podman/podman.sock')

# 列出容器（与 Docker 完全一致的 API）
for container in client.containers.list():
    print(container.name, container.status)

# 运行容器
container = client.containers.run("alpine", "echo hello", detach=True)
print(container.logs().decode())

# 大多数 docker-compose.yaml 可以直接使用

# 安装 podman-compose
pip3 install podman-compose

# 直接使用现有 compose 文件
cd /path/to/project
podman-compose up -d

# 检查状态
podman-compose ps
podman-compose logs

# docker-compose.yaml 修改清单

services:
  app:
    image: myapp:v1.0
    volumes:
      - ./data:/app/data:Z     # 1. 添加 :Z SELinux 标签
      # 如果不是 SELinux 系统，:Z 无副作用，建议保留
    ports:
      - "8080:80"              # 2. 避免 < 1024 的端口
    # 不要使用：               # 3. 移除不兼容配置
    #   container_name: xxx    #    （扩展时会冲突）
    #   network_mode: host     #    （Rootless 下行为不同）

  db:
    image: postgres:16
    tmpfs:
      - /tmp:size=100m         # 4. 添加 tmpfs 减少磁盘写入
    volumes:
      - pgdata:/var/lib/postgresql/data:Z

# .gitlab-ci.yml
# Before（Docker）:
#   image: docker:latest
#   services:
#     - docker:dind
#   script:
#     - docker build -t myapp .
#     - docker push registry.example.com/myapp

# After（Podman）:
build:
  image: quay.io/podman/stable
  services:
    - name: registry:2
      alias: registry
  variables:
    DOCKER_HOST: unix:///run/podman/podman.sock
  script:
    - podman build -t myapp .
    - podman tag myapp registry/myapp:latest
    - podman push registry/myapp:latest

# .github/workflows/build.yml
name: Build and Push

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Podman
        run: |
          sudo apt-get update
          sudo apt-get install -y podman

      - name: Login to Registry
        run: |
          echo "${{ secrets.REGISTRY_PASSWORD }}" | \
          podman login registry.example.com -u ${{ secrets.REGISTRY_USERNAME }} --password-stdin

      - name: Build Image
        run: podman build -t registry.example.com/myapp:${{ github.sha }} .

      - name: Push Image
        run: podman push registry.example.com/myapp:${{ github.sha }}

// Jenkinsfile
pipeline {
    agent {
        // 使用包含 Podman 的 Jenkins agent
        label 'podman-agent'
    }
    stages {
        stage('Build') {
            steps {
                sh 'podman build -t myapp:${BUILD_NUMBER} .'
            }
        }
        stage('Push') {
            steps {
                sh '''
                    echo "${REGISTRY_PASSWORD}" | podman login registry.example.com -u ${REGISTRY_USERNAME} --password-stdin
                    podman tag myapp:${BUILD_NUMBER} registry.example.com/myapp:${BUILD_NUMBER}
                    podman push registry.example.com/myapp:${BUILD_NUMBER}
                '''
            }
        }
    }
}

# Docker 默认以 root 运行
sudo docker run -p 80:80 nginx   # ✅ 可以绑定特权端口

# Podman 默认以 Rootless 运行
podman run -p 80:80 nginx        # ❌ Rootless 无法绑定 80 端口
podman run -p 8080:80 nginx      # ✅ 使用非特权端口

# Docker 中直接挂载目录
docker run -v /data:/data nginx  # ✅ 通常可以工作

# Podman（SELinux 系统）需要标签
podman run -v /data:/data:Z nginx  # ✅ 添加 :Z

# Docker 容器停止后仍占用名称
docker run --name web nginx
docker stop web
docker run --name web nginx  # ❌ 名称冲突

# Podman 同样，需要先删除
podman rm web
podman run --name web nginx

# Docker 默认添加 docker.io/library/ 前缀
docker pull alpine
# 等价于 docker.io/library/alpine:latest

# Podman 同样，但可能需要配置 registries.conf
podman pull alpine
# 等价于 docker.io/library/alpine:latest

# Dockerfile 中的 HEALTHCHECK 指令
HEALTHCHECK --interval=30s --timeout=3s \
    CMD curl -f http://localhost/ || exit 1

# Podman 对 HEALTHCHECK 的支持需要手动触发
podman healthcheck run <container>
podman inspect --format '{{.State.Health.Status}}' <container>

# Docker 中 systemd 作为 PID 1（需要 --privileged）
docker run --privileged centos /usr/sbin/init

# Podman 中 systemd 可以直接运行（更友好）
podman run --systemd=always fedora /usr/sbin/init
# 或
podman run --systemd=always centos /usr/lib/systemd/systemd

#!/bin/bash
# migration-test.sh — 验证从 Docker 到 Podman 的迁移

echo "=== Podman 迁移验证 ==="

# 1. 基本运行
echo -n "1. 基本容器运行: "
podman run --rm alpine echo "OK" > /dev/null 2>&1 && echo "✅" || echo "❌"

# 2. 端口映射
echo -n "2. 端口映射: "
podman run --rm -d --name test-port -p 18080:80 nginx:alpine > /dev/null 2>&1
sleep 2
curl -s http://localhost:18080 > /dev/null 2>&1 && echo "✅" || echo "❌"
podman rm -f test-port > /dev/null 2>&1

# 3. 卷挂载
echo -n "3. 卷挂载: "
mkdir -p /tmp/podman-test
echo "test" > /tmp/podman-test/file.txt
podman run --rm -v /tmp/podman-test:/data:Z alpine cat /data/file.txt | grep -q "test" && echo "✅" || echo "❌"
rm -rf /tmp/podman-test

# 4. 环境变量
echo -n "4. 环境变量: "
podman run --rm -e MY_VAR=hello alpine printenv MY_VAR | grep -q "hello" && echo "✅" || echo "❌"

# 5. 镜像构建
echo -n "5. 镜像构建: "
echo "FROM alpine" > /tmp/Dockerfile.test
echo "RUN echo built" >> /tmp/Dockerfile.test
podman build -t test-build -f /tmp/Dockerfile.test /tmp > /dev/null 2>&1 && echo "✅" || echo "❌"
podman rmi test-build > /dev/null 2>&1
rm /tmp/Dockerfile.test

# 6. Socket 兼容
echo -n "6. Socket 兼容: "
SOCKET=/run/user/$(id -u)/podman/podman.sock
[ -S "$SOCKET" ] && echo "✅" || echo "❌ (需要: systemctl --user enable podman.socket)"

# 7. 网络
echo -n "7. 自定义网络: "
podman network create test-net > /dev/null 2>&1
podman network inspect test-net > /dev/null 2>&1 && echo "✅" || echo "❌"
podman network rm test-net > /dev/null 2>&1

# 8. Secrets
echo -n "8. Secrets: "
echo "secret" | podman secret create test-secret - > /dev/null 2>&1
podman secret inspect test-secret > /dev/null 2>&1 && echo "✅" || echo "❌"
podman secret rm test-secret > /dev/null 2>&1

echo "=== 验证完成 ==="