sameersbn/apt-cacher-ng

sameersbn/apt-cacher-ng:3.3-20200524

• 简介
  • 贡献
  • 问题反馈
• 快速上手
  • 安装
  • 快速启动
  • 命令行参数
  • 数据持久化
  • Docker Compose
  • 使用方法
  • 日志
• 维护
  • 缓存过期
  • 升级
  • Shell访问

简介

Dockerfile 用于创建 Docker 容器镜像，运行 Apt-Cacher NG。

Apt-Cacher NG 是一个缓存代理，专门用于 Linux 发行版的包文件，主要针对 Debian（及 基于 Debian 的）发行版，但不仅限于这些。

贡献

如果您觉得此镜像有用，您可以通过以下方式提供帮助：

• 提交拉取请求，包含您的优秀功能和错误修复
• 帮助用户解决他们的 问题
• 通过 *** 支持此镜像的开发

问题反馈

在报告问题之前，请尝试将 Docker 更新到最新版本，并检查是否解决了问题。有关说明，请参考 Docker 安装指南。

SELinux 用户应尝试使用命令 setenforce 0 禁用 SELinux，查看是否解决问题。

如果上述建议没有帮助，请 报告您的问题 并提供以下信息：

• docker version 和 docker info 命令的输出
• 用于启动镜像的 docker run 命令或 docker-compose.yml。隐藏敏感信息。
• 请说明您是否使用 Boot2Docker、VirtualBox 等。

快速上手

安装

镜像的自动构建可在 https://hub.docker.com/r/sameersbn/apt-cacher-ng 获取，这是推荐的安装方式。

注意：构建也可在 Quay.io 获取

bash
docker pull sameersbn/apt-cacher-ng:3.3-20200524

或者，您也可以自行构建镜像：

bash
docker build -t sameersbn/apt-cacher-ng github.com/sameersbn/docker-apt-cacher-ng

快速启动

使用以下命令启动 Apt-Cacher NG：

bash
docker run --name apt-cacher-ng --init -d --restart=always \
  --publish 3142:3142 \
  --volume /srv/docker/apt-cacher-ng:/var/cache/apt-cacher-ng \
  sameersbn/apt-cacher-ng:3.3-20200524

或者，您可以使用示例 docker-compose.yml 文件通过 Docker Compose 启动容器

命令行参数

您可以通过在 docker run 命令中指定 apt-cacher-ng 的参数来自定义其启动命令。例如，以下命令打印 apt-cacher-ng 命令的帮助菜单：

bash
docker run --name apt-cacher-ng --init -it --rm \
  --publish 3142:3142 \
  --volume /srv/docker/apt-cacher-ng:/var/cache/apt-cacher-ng \
  sameersbn/apt-cacher-ng:3.3-20200524 -h

数据持久化

为使缓存在容器关闭和启动之间保持状态，您应将卷挂载到 /var/cache/apt-cacher-ng。

快速启动 命令已挂载卷以实现持久化。

SELinux 用户应更新主机挂载点的安全上下文，以便与 Docker 兼容：

bash
mkdir -p /srv/docker/apt-cacher-ng
chcon -Rt svirt_sandbox_file_t /srv/docker/apt-cacher-ng

Docker Compose

要通过 Docker Compose 运行 Apt-Cacher NG，请创建以下 docker-compose.yml 文件：

yaml
---
version: '3'

services:
  apt-cacher-ng:
    image: sameersbn/apt-cacher-ng
    container_name: apt-cacher-ng
    ports:
      - "3142:3142"
    volumes:
      - apt-cacher-ng:/var/cache/apt-cacher-ng
    restart: always

volumes:
  apt-cacher-ng:

然后可以在后台启动 Apt-Cache NG 服务：

bash
docker-compose up -d

使用方法

要在 Debian（及基于 Debian 的）主机上开始使用 Apt-Cacher NG，请创建配置文件 /etc/apt/apt.conf.d/01proxy，内容如下：

config
Acquire::HTTP::Proxy "http://172.17.0.1:3142";
Acquire::HTTPS::Proxy "false";

类似地，要在 Docker 容器中使用 Apt-Cacher NG，请在 Dockerfile 中任何 apt-get 命令之前添加以下行：

dockerfile
RUN echo 'Acquire::HTTP::Proxy "http://172.17.0.1:3142";' >> /etc/apt/apt.conf.d/01proxy \
 && echo 'Acquire::HTTPS::Proxy "false";' >> /etc/apt/apt.conf.d/01proxy

日志

要访问位于 /var/log/apt-cacher-ng 的 Apt-Cacher NG 日志，您可以使用 docker exec。例如，要跟踪日志：

bash
docker exec -it apt-cacher-ng tail -f /var/log/apt-cacher-ng/apt-cacher.log

维护

缓存过期

使用 命令行参数 功能，您可以指定 -e 参数来启动 Apt-Cacher NG 的缓存过期维护任务：

bash
docker run --name apt-cacher-ng --init -it --rm \
  --publish 3142:3142 \
  --volume /srv/docker/apt-cacher-ng:/var/cache/apt-cacher-ng \
  sameersbn/apt-cacher-ng:3.3-20200524 -e

也可以通过在 Web 浏览器中访问 url http://localhost:3142/acng-report.html 并选择 Start Scan and/or Expiration 选项，在运行的实例上执行此操作。

升级

要升级到新版本：

1. 下载更新的 Docker 镜像：

bash
docker pull sameersbn/apt-cacher-ng:3.3-20200524

2. 停止当前运行的镜像：

bash
docker stop apt-cacher-ng

3. 删除已停止的容器：

bash
docker rm -v apt-cacher-ng

4. 启动更新后的镜像：

bash
docker run --name apt-cacher-ng --init -d \
  [选项] \
  sameersbn/apt-cacher-ng:3.3-20200524

Shell访问

为了调试和维护，您可能需要访问容器的 shell。如果您使用的 Docker 版本为 1.3.0 或更高，您可以通过 docker exec 启动 bash 来访问运行中容器的 shell：

bash
docker exec -it apt-cacher-ng bash