InstaBox + Docker
常用指令速查表

npx instabox@latest exec my-machine -- docker ps
│   │               │    │                   │  └─ 在机器里真正执行的命令
│   │               │    │                   └──── 分隔符：后面是“给机器的命令”
│   │               │    └──────────────────────── 目标机器名
│   │               └───────────────────────────── 动作：在机器里执行命令
│   └───────────────────────────────────────────── instabox 这个工具
└───────────────────────────────────────────────── npx：临时下载并运行这个工具

FROM nginx:latest                                  # 基础镜像（第一行）
COPY index.html /usr/share/nginx/html/index.html   # 拷文件进镜像

services:
  web:                    # 服务名，同时也是组内的“通讯录名字”
    image: mynginx:v1     # 用哪个镜像（也可写 build: 现场按 Dockerfile 构建）
    ports:
      - "8080:80"         # 对外映射
  cache:
    image: redis:latest   # 没写 ports，所以只在组内互通

# 1. 起仓库（-v 让仓库数据存进 /data，容器删了镜像还在）
docker run -d -p 5000:5000 -v /data/home/registry-data:/var/lib/registry --name registry registry:2
curl http://localhost:5000/v2/            # 返回 {} = 活着
curl http://localhost:5000/v2/_catalog    # 看仓库里有哪些镜像

# 2. 推送：名字第一段带“仓库地址”才知道往哪推
docker tag mynginx:v1 localhost:5000/mynginx:v1
docker push localhost:5000/mynginx:v1
curl http://localhost:5000/v2/mynginx/tags/list   # 看某个镜像的标签

# 3. 拉回：删本地 → 从仓库 pull → digest 指纹一致才算真闭环
docker pull localhost:5000/mynginx:v1

docker volume create mydata
docker run --rm -v mydata:/data alpine sh -c 'echo "saved in volume" > /data/note.txt'
docker run --rm -v mydata:/data alpine cat /data/note.txt   # 换个全新容器也能读到 = 数据在卷里，不在容器里
docker volume ls / inspect 名字 / rm 名字

# 进程按自己的逻辑退出 = 无人值守的猝死，策略会拉起它
docker run -d --name crash --restart always alpine sh -c 'sleep 3; exit 1'
docker inspect -f '{{.RestartCount}}' crash   # 实测 8 秒涨到 7
docker rm -f crash                            # 失控演示容器一步强拆

FROM ubuntu:24.04                                  # 基础镜像和 SDK 双钉版，不用 latest
ARG SDK_VERSION=1.0.1                               # 与 Zephyr 4.4/4.5 配对；用 4.3 就改 0.17.4
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install --no-install-recommends -y \
      git cmake ninja-build gperf ccache dfu-util device-tree-compiler \
      wget python3-dev python3-venv python3-tk xz-utils file make \
      gcc gcc-multilib g++-multilib libsdl2-dev libmagic1 \
    && rm -rf /var/lib/apt/lists/*              # 主机依赖照官方清单，一层装完清缓存
ENV VIRTUAL_ENV=/opt/venv
ENV PATH=${VIRTUAL_ENV}/bin:${PATH}               # venv 写进 PATH，省掉每次 activate
RUN python3 -m venv ${VIRTUAL_ENV} && pip install --no-cache-dir west
WORKDIR /opt
RUN wget -q https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v${SDK_VERSION}/zephyr-sdk-${SDK_VERSION}_linux-x86_64_minimal.tar.xz \
    && tar -xf zephyr-sdk-${SDK_VERSION}_linux-x86_64_minimal.tar.xz \
    && rm zephyr-sdk-${SDK_VERSION}_linux-x86_64_minimal.tar.xz \
    && cd zephyr-sdk-${SDK_VERSION} && ./setup.sh -t arm-zephyr-eabi -h -c   # minimal 包 + 只装 ARM 工具链
ENV ZEPHYR_TOOLCHAIN_VARIANT=zephyr
ENV ZEPHYR_SDK_INSTALL_DIR=/opt/zephyr-sdk-${SDK_VERSION}
WORKDIR /workdir                                    # 源码运行时挂进来，不焊进镜像
CMD ["bash"]

docker build -t zephyr-dev:1.0.1 .
docker images zephyr-dev        # 先看一眼体积，心里有账
# 一次性编译（CI 式）：编完容器即删，产物留在挂载的工程目录里
docker run --rm -v /data/home/zephyrproject:/workdir zephyr-dev:1.0.1 \
  west build -p always -b nucleo_f103rb zephyr/samples/hello_world
# 交互开发：进容器慢慢敲，退出即删
docker run -it --rm -v /data/home/zephyrproject:/workdir zephyr-dev:1.0.1
ls /data/home/zephyrproject/build/zephyr/zephyr.bin   # 回到宿主机确认产物在

west update                     # 拉模块源码（已有工作区且没换版本可跳过）
west zephyr-export              # 注册 Zephyr 的 CMake 包
west packages pip --install     # Python 依赖跟 Zephyr 版本走，装在工作区侧

docker login                     # Username 填 Docker ID，Password 粘贴 PAT（只显示一次，存好）
docker tag mynginx:v1 <你的DockerID>/mynginx:v1
docker push <你的DockerID>/mynginx:v1     # 输出最后一行 digest: sha256:… 记下它
docker rmi <你的DockerID>/mynginx:v1      # 删本地，准备验闭环
docker pull <你的DockerID>/mynginx:v1     # 拉回时再看 Digest，两次一致才算真闭环
docker run -d -p 8080:80 <你的DockerID>/mynginx:v1   # 能跑起来 = 圆满

export CR_PAT=<你的令牌>            # 令牌先放环境变量，别直接写进命令历史
echo $CR_PAT | docker login ghcr.io -u <你的GitHub用户名> --password-stdin
docker tag mynginx:v1 ghcr.io/<你的GitHub用户名>/mynginx:v1   # 前缀 ghcr.io，必须全小写
docker push ghcr.io/<你的GitHub用户名>/mynginx:v1
docker rmi ghcr.io/<你的GitHub用户名>/mynginx:v1
docker pull ghcr.io/<你的GitHub用户名>/mynginx:v1     # 同样看 Digest 对照

name: build-and-push
on: [push]
permissions:
  contents: read
  packages: write          # 没这行 GITHUB_TOKEN 推不动包
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: docker/login-action@v3
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}
      - uses: docker/build-push-action@v6
        with:
          context: .
          push: true
          tags: ghcr.io/${{ github.repository_owner }}/mynginx:latest