# 部署工具

## 操作系统准备

### For MacOS

- [安装 Homebrew](https://brew.sh/)
- 安装 Podman

  ```bash
  brew install qemu
  brew install podman
  podman machine init # init the FIRST PODMAN MACHINE
  ```

- 启动 Podman `podman machine start`

### For Windows 10+

- 先决条件

  ![prerequisites](wsl/prerequisites.png)

- 安装 WSL

  ![install](wsl/install.png)

- 从[Windows Store](https://apps.microsoft.com/store/detail/ubuntu/9PDXGNCFSCZV)安装 ubuntu（版本不小于 **22.04**）

## Ubuntu 内安装容器工具包 `sudo apt install crun podman buildah`

## 镜像准备

```bash
# 解压镜像
sudo apt install -y bzip2
tar xf palm-alpine.tar.xz
# 导入镜像
podman load -i palm-alpine-TIMESTAMP.tar
# clone 代码 PLEASE CHANGE IT TO YOUR REPO
git clone -b agile https://github.com/iapt-platform/mint.git ~/workspace/iapt-platform/mint
git clone -b laravel https://github.com/iapt-platform/mint.git ~/workspace/iapt-platform/mint-laravel
# 启动镜像
cd ~/workspace
./iapt-platform/mint/docker/alpine/start.sh
```

## 部署

- 设置 client key

  ```bash
  cd deploy
  mkdir -p clients/CLIENT_ID/.ssh
  cd clients/CLIENT_ID
  # 创建 ssh key
  ssh-keygen -t ed25519 -f .ssh/id_ed25519 -C "your_email@example.com"
  ```

- 上传 `.ssh/id_ed25519.pub` 到服务器`/tmp`目录， 然后 `cat /tmp/id_ed25519.pub >> ~/.ssh/authorized_keys`
- 测试 ssh 连接 `ssh -i .ssh/id_ed25519 deploy@HOST`

  - Fix `Permissions xxxx for xxxx are too open`

    ![too open](ssh/too-open.png)

- 复制`cp ../../staging/hosts ./`并调整配置

- 命令

  ```bash
  cd deploy
  # 测试服务器状态
  peony -i clients/CLIENT_ID ping.yml
  # 全量部署
  peony -i clients/CLIENT_ID mint.yml -l GROUP
  # 按组部署
  peony -i clients/CLIENT_ID mint.yml -l GROUP
  ```

## 常用容器命令

```bash
# 清理
podman system reset
# 列出所有镜像
podman images
# 列出所有容器
podman ps -a
```

## 参考文档

- [Install Linux on Windows with WSL](https://learn.microsoft.com/en-us/windows/wsl/install)