Docker on Yison's Blog

Alpine系统下的apk指令

Sun, 09 Jun 2019 00:00:00 +0000

Alpine Linux 是一个面向安全应用的轻量级 Linux 发行版。它采用了 musl libc 和 busybox 以减小系统的体积和运行时资源消耗，同时还提供了自己的包管理工具 apk。

apk 常用命令速查

命令	说明
`apk update`	更新本地镜像源索引
`apk add <pkg>`	安装软件包
`apk del <pkg>`	卸载软件包
`apk upgrade`	升级所有已安装包
`apk search <pkg>`	搜索软件包
`apk info <pkg>`	查看软件包信息
`apk list`	列出已安装包
`apk fix`	修复或升级包

基础命令

更新镜像源

# 更新本地镜像源索引
apk update

update 命令会从各个镜像源列表下载 APKINDEX.tar.gz 并存储到本地缓存，一般在 /var/cache/apk/、/var/lib/apk/、/etc/apk/cache/ 目录下。

安装软件包

# 基本安装
apk add openssh openntp vim

# 不缓存安装（减小镜像体积）
apk add --no-cache mysql-client

# 从指定仓库安装
apk add docker --update-cache \
 --repository http://mirrors.ustc.edu.cn/alpine/v3.4/main/ \
 --allow-untrusted

安装指定版本

# 安装精确版本
apk add asterisk=1.6.0.21-r0

# 版本约束
apk add 'asterisk<1.6.1' # 小于
apk add 'asterisk>1.6.1' # 大于
apk add 'asterisk>=1.6.1' # 大于等于
apk add 'asterisk~=1.6.1' # 约等于

卸载软件包

# 卸载并删除相关文件
apk del openssh openntp vim

升级软件包

# 更新镜像源
apk update

# 升级所有已安装包
apk upgrade

# 升级指定软件包
apk add --upgrade busybox

搜索软件包

# 搜索所有可用包
apk search

# 显示详细信息
apk search -v

# 通过名称查找
apk search -v 'acf*'

# 通过描述查找
apk search -v -d 'docker'

查看软件包信息

# 列出所有已安装包
apk info

# 查看指定包详细信息
apk info -a zlib

# 查看文件属于哪个包
apk info --who-owns /sbin/lbu

常用场景

Docker 容器中安装工具

# 更新并安装基础工具
apk update && apk add --no-cache \
 curl \
 wget \
 git \
 vim \
 htop \
 bash \
 bash-completion

PHP 运行环境

apk add --no-cache \
 php \
 php-fpm \
 php-mysql \
 php-mbstring \
 php-xml \
 php-curl \
 php-json

Nginx 运行环境

apk add --no-cache \
 nginx \
 openssl \
 pcre \
 zlib

数据库客户端

# MySQL 客户端
apk add --no-cache mysql-client

# PostgreSQL 客户端
apk add --no-cache postgresql-client

# Redis 客户端
apk add --no-cache redis

Alpine 中文支持

如果需要在 Alpine 中使用中文，需要安装 glibc：

# 安装 glibc（解决 locale 问题）
apk --no-cache add ca-certificates wget

wget -q -O /etc/apk/keys/sgerrand.rsa.pub \
 https://alpine-pkgs.sgerrand.com/sgerrand.rsa.pub

wget https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.29-r0/glibc-2.29-r0.apk
apk add glibc-2.29-r0.apk

wget https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.29-r0/glibc-bin-2.29-r0.apk
wget https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.29-r0/glibc-i18n-2.29-r0.apk
apk add glibc-bin-2.29-r0.apk glibc-i18n-2.29-r0.apk

# 生成 locale
/usr/glibc-compat/bin/localedef -i en_US -f UTF-8 en_US.UTF-8

镜像源配置

官方源

# /etc/apk/repositories
https://dl-cdn.alpinelinux.org/alpine/v3.19/main
https://dl-cdn.alpinelinux.org/alpine/v3.19/community

国内镜像

# 阿里云镜像
echo "https://mirrors.aliyun.com/alpine/v3.19/main" > /etc/apk/repositories
echo "https://mirrors.aliyun.com/alpine/v3.19/community" >> /etc/apk/repositories

# 中科大镜像
echo "https://mirrors.ustc.edu.cn/alpine/v3.19/main" > /etc/apk/repositories
echo "https://mirrors.ustc.edu.cn/alpine/v3.19/community" >> /etc/apk/repositories

# 腾讯云镜像
echo "https://mirrors.cloud.tencent.com/alpine/v3.19/main" > /etc/apk/repositories
echo "https://mirrors.cloud.tencent.com/alpine/v3.19/community" >> /etc/apk/repositories

进阶命令

查看依赖关系

# 查看包依赖
apk info -r php

# 查看反向依赖（哪些包依赖它）
apk info -R nginx

缓存管理

# 下载包到缓存
apk cache download

# 清理缓存
apk cache clean

# 修复缓存
apk cache fix

版本比较

# 比较版本
apk version abc 1.2.3-r0

# 测试版本表达式
apk version --test 'bash>3.1'

常见问题

Q: apk add 报错 signature is invalid

A: 更新镜像源或添加 --allow-untrusted 参数

Q: 找不到包

A: 确认仓库配置正确后执行 apk update

Q: 依赖冲突

A: 使用 apk add --force-overwrite 或查看冲突详情

Docker 最佳实践

# 使用国内镜像源
RUN echo "https://mirrors.aliyun.com/alpine/v3.19/main" > /etc/apk/repositories \
 && apk add --no-cache \
 nginx \
 php-fpm \
 php-mysqli \
 && rm -rf /var/cache/apk/*

# 多阶段构建
FROM alpine:3.19 AS builder
RUN apk add --no-cache go

FROM alpine:3.19
COPY --from=builder /usr/local/bin/ /usr/local/bin/

参考链接

Docker从零构建php-nginx-alpine镜像

Fri, 09 Nov 2018 00:00:00 +0000

虽然之前用 Docker 环境运行了一些项目，但对于镜像这块还不是很理解，且网上现成的镜像都包含太多用不到的库，所以决定从零开始构建一个自己的镜像。

选择 Alpine Linux 作为基础镜像

# 拉取 Alpine 镜像
docker pull alpine:latest

# 查看镜像
docker images alpine

Alpine Linux 是一个面向安全的轻量级 Linux 发行版，镜像只有 5MB 左右。

运行并进入容器

# 交互式运行
docker run -it alpine /bin/sh

# 或后台运行
docker run -d --name my-alpine alpine:latest
docker exec -it my-alpine /bin/sh

安装 PHP 和 Nginx

# 更新包索引
apk update

# 安装 PHP 和 Nginx
apk add php7 php7-fpm php7-cli nginx

# 如果使用 PHP 8.x
apk add php81 php81-fpm php81-cli nginx

⚠️ 提示：Alpine 3.18+ 使用 php81、php82 等命名

安装 PHP 扩展

# 安装常用扩展
apk add php7-mysqli \
 php7-pdo_mysql \
 php7-mbstring \
 php7-json \
 php7-zlib \
 php7-gd \
 php7-intl \
 php7-session \
 php7-curl \
 php7-posix \
 php7-fileinfo \
 php7-simplexml \
 php7-xml \
 php7-openssl \
 php7-dom \
 php7-phar

# PHP 8.x 扩展
apk add php81-mysqli php81-pdo_mysql php81-mbstring php81-xml php81-curl

目录结构

软件	路径
PHP 配置	`/etc/php7`
Nginx 配置	`/etc/nginx`
网站目录	`/var/www/localhost/htdocs`
日志目录	`/var/log/nginx`

配置 PHP-FPM

修改 www.conf

vi /etc/php7/php-fpm.d/www.conf

[www]
user = nobody
group = nobody
listen = 127.0.0.1:9000

配置 Nginx

nginx.conf

vi /etc/nginx/nginx.conf

worker_processes auto;
error_log /var/log/nginx/error.log warn;
pid /run/nginx.pid;

events {
 worker_connections 1024;
}

http {
 include /etc/nginx/mime.types;
 default_type application/octet-stream;
 
 log_format main '$remote_addr - $remote_user [$time_local] "$request" '
 '$status $body_bytes_sent "$http_referer" '
 '"$http_user_agent" "$http_x_forwarded_for"';
 
 access_log /var/log/nginx/access.log main;
 
 sendfile on;
 keepalive_timeout 65;
 
 include /etc/nginx/conf.d/*.conf;
}

default.conf

vi /etc/nginx/conf.d/default.conf

server {
 listen 80 default_server;
 root /var/www/localhost/htdocs;
 index index.php index.html;
 
 server_name localhost;
 
 location / {
 try_files $uri $uri/ =404;
 }
 
 location ~ \.php$ {
 fastcgi_pass 127.0.0.1:9000;
 fastcgi_index index.php;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 include fastcgi_params;
 }
 
 location ~ /\.ht {
 deny all;
 }
}

启动服务

# 创建必要的目录
mkdir -p /run/nginx

# 启动 PHP-FPM
/usr/sbin/php-fpm7

# 启动 Nginx
/usr/sbin/nginx

# 测试
curl http://localhost

创建 Dockerfile

基础版本

# Dockerfile
FROM alpine:latest

LABEL maintainer="yisonli <email@example.com>"
LABEL version="1.0"
LABEL description="PHP7 + Nginx on Alpine Linux"

# 安装系统工具
RUN apk add --no-cache \
 openssl \
 curl \
 ca-certificates \
 bash

# 安装 PHP 和扩展
RUN apk add --no-cache \
 php7 \
 php7-fpm \
 php7-mysqli \
 php7-pdo_mysql \
 php7-mbstring \
 php7-json \
 php7-gd \
 php7-curl

# 安装 Nginx
RUN apk add --no-cache nginx

# 配置 PHP-FPM
RUN mkdir -p /run/nginx \
 && chown -R nobody:nobody /var/www/localhost

# 复制配置文件
COPY nginx.conf /etc/nginx/nginx.conf
COPY default.conf /etc/nginx/conf.d/
COPY php.ini /etc/php7/php.ini
COPY php-fpm.conf /etc/php7/php-fpm.conf

# 复制应用代码
COPY ./app /var/www/localhost/htdocs

# 暴露端口
EXPOSE 80 443

# 启动脚本
COPY start.sh /start.sh
RUN chmod +x /start.sh

CMD ["/start.sh"]

启动脚本

#!/bin/sh
# start.sh

# 创建必要目录
mkdir -p /run/nginx /var/log/nginx /var/tmp/php-fpm

# 设置权限
chown -R nobody:nobody /var/www/localhost

# 启动 PHP-FPM
/usr/sbin/php-fpm7 &

# 启动 Nginx
/usr/sbin/nginx -g 'daemon off;'

PHP 配置文件

; php.ini
upload_max_filesize = 50M
post_max_size = 50M
memory_limit = 128M
max_execution_time = 300

docker-compose.yml

version: '3.8'

services:
 web:
 build: .
 ports:
 - "8080:80"
 volumes:
 - ./app:/var/www/localhost/htdocs
 environment:
 - PHP_MEMORY_LIMIT=256M
 restart: unless-stopped

 mysql:
 image: mysql:8.0
 environment:
 MYSQL_ROOT_PASSWORD: secret
 MYSQL_DATABASE: app
 volumes:
 - mysql_data:/var/lib/mysql

volumes:
 mysql_data:

构建并运行

# 构建镜像
docker build -t my-php-app:1.0 .

# 运行容器
docker run -d -p 8080:80 --name my-app my-php-app:1.0

# 使用 docker-compose
docker-compose up -d

# 查看日志
docker logs -f my-app

# 进入容器
docker exec -it my-app /bin/sh

常用 Docker 命令

# 查看运行中的容器
docker ps

# 查看所有容器
docker ps -a

# 删除未运行的容器
docker rm $(docker ps -a -q)

# 提交镜像
docker commit -a "yisonli" -m "my php7-nginx" CONTAINER_ID my-php-app:0.1

# 添加标签
docker tag IMAGE_ID my-repo/my-image:tag

# 推送镜像
docker push my-repo/my-image:tag

共享文件夹

# 挂载本地目录
docker run -v $(pwd)/www:/var/www/localhost/htdocs \
 -p 8080:80 \
 my-php-app:1.0

优化建议

使用多阶段构建减小镜像体积
合并 RUN 指令减少层数
使用 .dockerignore排除不需要的文件
使用国内镜像源加速构建

多阶段构建示例

# 构建阶段
FROM composer:2 as builder
WORKDIR /app
COPY composer.* ./
RUN composer install --no-dev
COPY . .
RUN composer dump-autoload --optimize

# 运行阶段
FROM alpine:latest
COPY --from=builder /app /var/www/localhost/htdocs
# ...