# docker_pull

**Repository Path**: feng-jianqing/docker_pull

## Basic Information

- **Project Name**: docker_pull
- **Description**: python拉取镜像脚本
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-22
- **Last Updated**: 2025-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

以下是为该脚本生成的 `README.md` 文件内容，包含使用说明和免责声明：

---

# Docker 镜像拉取与打包工具

这是一个 Python 脚本，用于从 Docker 镜像仓库（如 Docker Hub 或私有仓库）拉取镜像，并将其打包为 `.tar` 文件，以便后续使用 `docker load` 加载。

## 功能
- 支持从 Docker Hub 或私有仓库拉取镜像。
- 支持多架构镜像（如 `amd64`、`arm64` 等）。
- 将镜像打包为 `.tar` 文件，兼容 `docker load`。
- 支持私有仓库的认证（用户名和密码）。
- 显示下载进度条，实时监控下载状态。

## 使用说明

### 安装依赖
确保已安装以下 Python 库：
```bash
pip install requests tqdm
```

### 运行脚本
```bash
python puller.py <image_url> <architecture> <username> <password>
```

#### 参数说明
- `<image_url>`：镜像的完整 URL 或名称（如 `nginx:latest` 或 `swr.cn-south-1.myhuaweicloud.com/nginx:latest`）。
- `<architecture>`：镜像的架构（如 `amd64`、`arm64`）。
- `<username>`：私有仓库的用户名（可选）。
- `<password>`：私有仓库的密码（可选）。

#### 示例
1. 从 Docker Hub 拉取公共镜像：
   ```bash
   python puller.py nginx:latest amd64
   ```

2. 从 Docker Hub 拉取私有镜像：
   ```bash
   python puller.py private-repo/image:tag amd64 <username> <password>
   ```

3. 从私有仓库拉取镜像：
   ```bash
   python puller.py swr.cn-south-1.myhuaweicloud.com/nginx:latest amd64 <username> <password>
   ```

### 加载镜像
使用 `docker load` 加载生成的 `.tar` 文件：
```bash
docker load -i <tar_filename>
```

### 检查镜像
加载完成后，使用以下命令检查镜像：
```bash
docker images
```

---

## 免责声明

本脚本的代码由 AI 生成，仅供学习和参考使用。使用者需自行承担使用该脚本可能带来的风险和责任。作者和 AI 不对以下情况负责：
1. 因使用本脚本导致的任何直接或间接损失。
2. 因网络问题、镜像仓库故障或其他不可抗力导致的脚本运行失败。
3. 因脚本生成的 `.tar` 文件不兼容或损坏导致的 `docker load` 失败。

建议在使用本脚本之前，仔细阅读代码并理解其功能。如有疑问，请咨询专业人士。

---