mirror of
https://github.com/yeasy/docker_practice.git
synced 2026-03-25 03:05:32 +00:00
Remove blank lines after code block markers
This commit is contained in:
@@ -25,26 +25,22 @@ $ DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
|
||||
$ mkdir -p $DOCKER_CONFIG/cli-plugins
|
||||
$ curl -SL https://github.com/docker/compose/releases/download/v5.1.0/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose
|
||||
```
|
||||
|
||||
之后,执行
|
||||
|
||||
```bash
|
||||
$ chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose
|
||||
```
|
||||
|
||||
### 11.2.2 测试安装
|
||||
|
||||
```bash
|
||||
$ docker compose version
|
||||
Docker Compose version v5.1.0
|
||||
```
|
||||
|
||||
### 11.2.3 bash 补全命令
|
||||
|
||||
```bash
|
||||
$ curl -L https://raw.githubusercontent.com/docker/compose/v5.1.0/contrib/completion/bash/docker-compose | sudo tee /etc/bash_completion.d/docker-compose > /dev/null
|
||||
```
|
||||
|
||||
### 11.2.4 卸载
|
||||
|
||||
如果是二进制包方式安装的,删除二进制文件即可。
|
||||
|
||||
@@ -37,7 +37,6 @@ def hello():
|
||||
if __name__ == "__main__":
|
||||
app.run(host="0.0.0.0", debug=True)
|
||||
```
|
||||
|
||||
#### Dockerfile
|
||||
|
||||
编写 `Dockerfile` 文件,内容为
|
||||
@@ -49,7 +48,6 @@ WORKDIR /code
|
||||
RUN pip install redis flask
|
||||
CMD ["python", "app.py"]
|
||||
```
|
||||
|
||||
#### compose.yaml
|
||||
|
||||
编写 `compose.yaml` 文件,这是 Compose 推荐使用的主模板文件 (也兼容 `docker-compose.yml` 等历史文件名)。
|
||||
@@ -64,13 +62,11 @@ services:
|
||||
redis:
|
||||
image: "redis:alpine"
|
||||
```
|
||||
|
||||
#### 运行 compose 项目
|
||||
|
||||
```bash
|
||||
$ docker compose up
|
||||
```
|
||||
|
||||
此时访问本地 `5000` 端口,每次刷新页面,计数就会加 1。
|
||||
|
||||
|
||||
@@ -81,13 +77,11 @@ $ docker compose up
|
||||
```bash
|
||||
$ docker compose up -d
|
||||
```
|
||||
|
||||
#### 停止
|
||||
|
||||
```bash
|
||||
$ docker compose stop
|
||||
```
|
||||
|
||||
#### 进入服务
|
||||
|
||||
```bash
|
||||
@@ -96,37 +90,31 @@ $ docker compose exec redis sh
|
||||
127.0.0.1:6379> get hits
|
||||
"9"
|
||||
```
|
||||
|
||||
#### 查看日志
|
||||
|
||||
```bash
|
||||
$ docker compose logs -f
|
||||
```
|
||||
|
||||
#### 构建镜像
|
||||
|
||||
```bash
|
||||
$ docker compose build
|
||||
```
|
||||
|
||||
#### 启动服务
|
||||
|
||||
```bash
|
||||
$ docker compose start
|
||||
```
|
||||
|
||||
#### 运行一次性命令
|
||||
|
||||
```bash
|
||||
$ docker compose run web python app.py
|
||||
```
|
||||
|
||||
#### 验证 Compose 文件
|
||||
|
||||
```bash
|
||||
$ docker compose config
|
||||
```
|
||||
|
||||
#### 删除项目
|
||||
|
||||
```bash
|
||||
|
||||
@@ -13,7 +13,6 @@ Docker Compose 提供了丰富的命令来管理项目和容器。本节将详
|
||||
```bash
|
||||
docker compose [-f=<arg>...] [options] [COMMAND] [ARGS...]
|
||||
```
|
||||
|
||||
### 11.4.2 命令选项
|
||||
|
||||
* `-f, --file FILE` 指定使用的 Compose 模板文件。默认会自动识别 `compose.yaml` (也兼容 `docker-compose.yml` 等),并且可以多次指定。
|
||||
@@ -75,7 +74,6 @@ docker compose [-f=<arg>...] [options] [COMMAND] [ARGS...]
|
||||
```bash
|
||||
$ docker compose kill -s SIGINT
|
||||
```
|
||||
|
||||
#### `logs`
|
||||
|
||||
格式为 `docker compose logs [options] [SERVICE...]`。
|
||||
@@ -159,7 +157,6 @@ $ docker compose kill -s SIGINT
|
||||
```bash
|
||||
$ docker compose run ubuntu ping docker.com
|
||||
```
|
||||
|
||||
将会启动一个 ubuntu 服务容器,并执行 `ping docker.com` 命令。
|
||||
|
||||
默认情况下,如果存在关联,则所有关联的服务将会自动被启动,除非这些服务已经在运行中。
|
||||
@@ -177,7 +174,6 @@ $ docker compose run ubuntu ping docker.com
|
||||
```bash
|
||||
$ docker compose run --no-deps web python manage.py shell
|
||||
```
|
||||
|
||||
将不会启动 web 容器所关联的其它容器。
|
||||
|
||||
选项:
|
||||
@@ -213,7 +209,6 @@ $ docker compose run --no-deps web python manage.py shell
|
||||
```bash
|
||||
$ docker compose scale web=3 db=2
|
||||
```
|
||||
|
||||
将启动 3 个容器运行 web 服务,2 个容器运行 db 服务。
|
||||
|
||||
> **提示**:部分版本的 Compose 可能不再提供独立的 `scale` 子命令 (或不推荐使用)。此时可使用 `docker compose up` 的 `--scale` 选项达到同样效果:
|
||||
@@ -316,7 +311,6 @@ services:
|
||||
- action: rebuild
|
||||
path: package.json
|
||||
```
|
||||
|
||||
选项:
|
||||
|
||||
* `--no-up` 不自动启动服务。
|
||||
|
||||
@@ -13,7 +13,6 @@ services:
|
||||
volumes:
|
||||
- "/data"
|
||||
```
|
||||
|
||||
注意每个服务都必须通过 `image` 指令指定镜像或 `build` 指令 (需要 Dockerfile) 等来自动构建生成镜像。
|
||||
|
||||
如果使用 `build` 指令,在 `Dockerfile` 中设置的选项 (例如:`CMD`、`EXPOSE`、`VOLUME`、`ENV` 等) 将会自动被获取,无需在 Compose 文件中重复设置。
|
||||
@@ -29,7 +28,6 @@ services:
|
||||
webapp:
|
||||
build: ./dir
|
||||
```
|
||||
|
||||
你也可以使用 `context` 指令指定 `Dockerfile` 所在文件夹的路径。
|
||||
|
||||
使用 `dockerfile` 指令指定 `Dockerfile` 文件名。
|
||||
@@ -45,7 +43,6 @@ services:
|
||||
args:
|
||||
buildno: 1
|
||||
```
|
||||
|
||||
使用 `cache_from` 指定构建镜像的缓存
|
||||
|
||||
```yaml
|
||||
@@ -55,7 +52,6 @@ build:
|
||||
- alpine:latest
|
||||
- corp/web_app:3.14
|
||||
```
|
||||
|
||||
### 11.5.2 `cap_add, cap_drop`
|
||||
|
||||
指定容器的内核能力 (capacity) 分配。
|
||||
@@ -66,14 +62,12 @@ build:
|
||||
cap_add:
|
||||
- ALL
|
||||
```
|
||||
|
||||
去掉 NET_ADMIN 能力可以指定为:
|
||||
|
||||
```yaml
|
||||
cap_drop:
|
||||
- NET_ADMIN
|
||||
```
|
||||
|
||||
### 11.5.3 `command`
|
||||
|
||||
覆盖容器启动后默认执行的命令。
|
||||
@@ -81,7 +75,6 @@ cap_drop:
|
||||
```yaml
|
||||
command: echo "hello world"
|
||||
```
|
||||
|
||||
### 11.5.4 `configs`
|
||||
|
||||
`configs` 来自 Compose Specification。它在 Swarm 中是原生对象;在本地 `docker compose` 模式下通常以文件挂载的形式实现,具体能力取决于 Compose 版本与运行平台。
|
||||
@@ -95,7 +88,6 @@ command: echo "hello world"
|
||||
```yaml
|
||||
cgroup_parent: cgroups_1
|
||||
```
|
||||
|
||||
### 11.5.6 `container_name`
|
||||
|
||||
指定容器名称。默认将会使用 `项目名称_服务名称_序号` 这样的格式。
|
||||
@@ -103,7 +95,6 @@ cgroup_parent: cgroups_1
|
||||
```yaml
|
||||
container_name: docker-web-container
|
||||
```
|
||||
|
||||
> 注意:指定容器名称后,该服务将无法进行扩展 (scale),因为 Docker 不允许多个容器具有相同的名称。
|
||||
|
||||
### 11.5.7 `deploy`
|
||||
@@ -118,7 +109,6 @@ container_name: docker-web-container
|
||||
devices:
|
||||
- "/dev/ttyUSB1:/dev/ttyUSB0"
|
||||
```
|
||||
|
||||
### 11.5.9 `depends_on`
|
||||
|
||||
解决容器的依赖、启动先后的问题。以下例子中会先启动 `redis` `db` 再启动 `web`
|
||||
@@ -137,7 +127,6 @@ services:
|
||||
db:
|
||||
image: postgres
|
||||
```
|
||||
|
||||
> 注意:`web` 服务不会等待 `redis` `db` “完全启动” 之后才启动。
|
||||
|
||||
### 11.5.10 `dns`
|
||||
@@ -151,7 +140,6 @@ dns:
|
||||
- 8.8.8.8
|
||||
- 114.114.114.114
|
||||
```
|
||||
|
||||
### 11.5.11 `dns_search`
|
||||
|
||||
配置 `DNS` 搜索域。可以是一个值,也可以是一个列表。
|
||||
@@ -163,7 +151,6 @@ dns_search:
|
||||
- domain1.example.com
|
||||
- domain2.example.com
|
||||
```
|
||||
|
||||
### 11.5.12 `tmpfs`
|
||||
|
||||
挂载一个 tmpfs 文件系统到容器。
|
||||
@@ -174,7 +161,6 @@ tmpfs:
|
||||
- /run
|
||||
- /tmp
|
||||
```
|
||||
|
||||
### 11.5.13 `env_file`
|
||||
|
||||
从文件中获取环境变量,可以为单独的文件路径或列表。
|
||||
@@ -191,16 +177,13 @@ env_file:
|
||||
- ./apps/web.env
|
||||
- /opt/secrets.env
|
||||
```
|
||||
|
||||
环境变量文件中每一行必须符合格式,支持 `#` 开头的注释行。
|
||||
|
||||
```bash
|
||||
|
||||
## common.env: Set development environment
|
||||
|
||||
PROG_ENV=development
|
||||
```
|
||||
|
||||
### 11.5.14 `environment`
|
||||
|
||||
设置环境变量。你可以使用数组或字典两种格式。
|
||||
@@ -216,13 +199,11 @@ environment:
|
||||
- RACK_ENV=development
|
||||
- SESSION_SECRET
|
||||
```
|
||||
|
||||
如果变量名称或者值中用到 `true|false,yes|no` 等表达[布尔](https://yaml.org/type/bool.html)含义的词汇,最好放到引号里,避免 YAML 自动解析某些内容为对应的布尔语义。这些特定词汇,包括
|
||||
|
||||
```bash
|
||||
y|Y|yes|Yes|YES|n|N|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF
|
||||
```
|
||||
|
||||
### 11.5.15 `expose`
|
||||
|
||||
暴露端口,但不映射到宿主机,只被连接的服务访问。
|
||||
@@ -234,7 +215,6 @@ expose:
|
||||
- "3000"
|
||||
- "8000"
|
||||
```
|
||||
|
||||
### 11.5.16 `external_links`
|
||||
|
||||
> 注意:不建议使用该指令。
|
||||
@@ -247,7 +227,6 @@ external_links:
|
||||
- project_db_1:mysql
|
||||
- project_db_1:postgresql
|
||||
```
|
||||
|
||||
### 11.5.17 `extra_hosts`
|
||||
|
||||
类似 Docker 中的 `--add-host` 参数,指定额外的 host 名称映射信息。
|
||||
@@ -257,14 +236,12 @@ extra_hosts:
|
||||
- "googledns:8.8.8.8"
|
||||
- "dockerhub:52.1.157.61"
|
||||
```
|
||||
|
||||
会在启动后的服务容器中 `/etc/hosts` 文件中添加如下两条条目。
|
||||
|
||||
```bash
|
||||
8.8.8.8 googledns
|
||||
52.1.157.61 dockerhub
|
||||
```
|
||||
|
||||
### 11.5.18 `healthcheck`
|
||||
|
||||
通过命令检查容器是否健康运行。
|
||||
@@ -276,7 +253,6 @@ healthcheck:
|
||||
timeout: 10s
|
||||
retries: 3
|
||||
```
|
||||
|
||||
### 11.5.19 `image`
|
||||
|
||||
指定为镜像名称或镜像 ID。如果镜像在本地不存在,`Compose` 将会尝试拉取这个镜像。
|
||||
@@ -286,7 +262,6 @@ image: ubuntu
|
||||
image: orchardup/postgresql
|
||||
image: a4bc65fd
|
||||
```
|
||||
|
||||
### 11.5.20 `labels`
|
||||
|
||||
为容器添加 Docker 元数据 (metadata) 信息。例如可以为容器添加辅助说明信息。
|
||||
@@ -297,7 +272,6 @@ labels:
|
||||
com.startupteam.department: "devops department"
|
||||
com.startupteam.release: "rc3 for v1.0"
|
||||
```
|
||||
|
||||
### 11.5.21 `links`
|
||||
|
||||
> 注意:不推荐使用该指令。容器之间应通过 Docker 网络 (networks) 进行互联。
|
||||
@@ -312,7 +286,6 @@ logging:
|
||||
options:
|
||||
syslog-address: "tcp://192.168.0.42:123"
|
||||
```
|
||||
|
||||
目前支持三种日志驱动类型。
|
||||
|
||||
```yaml
|
||||
@@ -320,7 +293,6 @@ driver: "json-file"
|
||||
driver: "syslog"
|
||||
driver: "none"
|
||||
```
|
||||
|
||||
`options` 配置日志驱动的相关参数。
|
||||
|
||||
```yaml
|
||||
@@ -328,7 +300,6 @@ options:
|
||||
max-size: "200k"
|
||||
max-file: "10"
|
||||
```
|
||||
|
||||
### 11.5.23 `network_mode`
|
||||
|
||||
设置网络模式。使用和 `docker run` 的 `--network` 参数一样的值。
|
||||
@@ -340,13 +311,11 @@ network_mode: "none"
|
||||
network_mode: "service:[service name]"
|
||||
network_mode: "container:[container name/id]"
|
||||
```
|
||||
|
||||
### 11.5.24 `networks`
|
||||
|
||||
配置容器连接的网络。
|
||||
|
||||
```yaml
|
||||
|
||||
services:
|
||||
|
||||
some-service:
|
||||
@@ -358,7 +327,6 @@ networks:
|
||||
some-network:
|
||||
other-network:
|
||||
```
|
||||
|
||||
### 11.5.25 `pid`
|
||||
|
||||
跟主机系统共享进程命名空间。打开该选项的容器之间,以及容器和宿主机系统之间可以通过进程 ID 来相互访问和操作。
|
||||
@@ -366,7 +334,6 @@ networks:
|
||||
```yaml
|
||||
pid: "host"
|
||||
```
|
||||
|
||||
### 11.5.26 `ports`
|
||||
|
||||
暴露端口信息。
|
||||
@@ -380,7 +347,6 @@ ports:
|
||||
- "49100:22"
|
||||
- "127.0.0.1:8001:8001"
|
||||
```
|
||||
|
||||
*注意:当使用 `HOST:CONTAINER` 格式来映射端口时,如果你使用的容器端口小于 60 并且没放到引号里,可能会得到错误结果,因为 `YAML` 会自动解析 `xx:yy` 这种数字格式为 60 进制。为避免出现这种问题,建议数字串都采用引号包括起来的字符串格式。*
|
||||
|
||||
### 11.5.27 `secrets`
|
||||
@@ -388,7 +354,6 @@ ports:
|
||||
存储敏感数据,例如 `mysql` 服务密码。
|
||||
|
||||
```yaml
|
||||
|
||||
services:
|
||||
|
||||
mysql:
|
||||
@@ -405,7 +370,6 @@ secrets:
|
||||
my_other_secret:
|
||||
external: true
|
||||
```
|
||||
|
||||
### 11.5.28 `security_opt`
|
||||
|
||||
指定容器模板标签 (label) 机制的默认属性 (用户、角色、类型、级别等)。例如配置标签的用户名和角色名。
|
||||
@@ -415,7 +379,6 @@ security_opt:
|
||||
- label:user:USER
|
||||
- label:role:ROLE
|
||||
```
|
||||
|
||||
### 11.5.29 `stop_signal`
|
||||
|
||||
设置另一个信号来停止容器。在默认情况下使用的是 SIGTERM 停止容器。
|
||||
@@ -423,7 +386,6 @@ security_opt:
|
||||
```yaml
|
||||
stop_signal: SIGUSR1
|
||||
```
|
||||
|
||||
### 11.5.30 `sysctls`
|
||||
|
||||
配置容器内核参数。
|
||||
@@ -437,7 +399,6 @@ sysctls:
|
||||
- net.core.somaxconn=1024
|
||||
- net.ipv4.tcp_syncookies=0
|
||||
```
|
||||
|
||||
### 11.5.31 `ulimits`
|
||||
|
||||
指定容器的 ulimits 限制值。
|
||||
@@ -451,7 +412,6 @@ sysctls:
|
||||
soft: 20000
|
||||
hard: 40000
|
||||
```
|
||||
|
||||
### 11.5.32 `volumes`
|
||||
|
||||
数据卷所挂载路径设置。可以设置为宿主机路径 (`HOST:CONTAINER`) 或者数据卷名称 (`VOLUME:CONTAINER`),并且可以设置访问模式 (`HOST:CONTAINER:ro`)。
|
||||
@@ -464,7 +424,6 @@ volumes:
|
||||
- cache/:/tmp/cache
|
||||
- ~/configs:/etc/configs/:ro
|
||||
```
|
||||
|
||||
如果路径为数据卷名称,必须在文件中配置数据卷。
|
||||
|
||||
```yaml
|
||||
@@ -477,7 +436,6 @@ services:
|
||||
volumes:
|
||||
mysql_data:
|
||||
```
|
||||
|
||||
### 11.5.33 其它指令
|
||||
|
||||
此外,还有包括 `domainname, entrypoint, hostname, ipc, mac_address, privileged, read_only, shm_size, restart, stdin_open, tty, user, working_dir` 等指令,基本跟 `docker run` 中对应参数的功能一致。
|
||||
@@ -487,19 +445,16 @@ volumes:
|
||||
```yaml
|
||||
entrypoint: /code/entrypoint.sh
|
||||
```
|
||||
|
||||
指定容器中运行应用的用户名。
|
||||
|
||||
```yaml
|
||||
user: nginx
|
||||
```
|
||||
|
||||
指定容器中工作目录。
|
||||
|
||||
```yaml
|
||||
working_dir: /code
|
||||
```
|
||||
|
||||
指定容器中搜索域名、主机名、mac 地址等。
|
||||
|
||||
```yaml
|
||||
@@ -507,37 +462,31 @@ domainname: your_website.com
|
||||
hostname: test
|
||||
mac_address: 08-00-27-00-0C-0A
|
||||
```
|
||||
|
||||
允许容器中运行一些特权命令。
|
||||
|
||||
```yaml
|
||||
privileged: true
|
||||
```
|
||||
|
||||
指定容器退出后的重启策略为始终重启。该命令对保持服务始终运行十分有效,在生产环境中推荐配置为 `always` 或者 `unless-stopped`。
|
||||
|
||||
```yaml
|
||||
restart: always
|
||||
```
|
||||
|
||||
以只读模式挂载容器的 root 文件系统,意味着不能对容器内容进行修改。
|
||||
|
||||
```yaml
|
||||
read_only: true
|
||||
```
|
||||
|
||||
打开标准输入,可以接受外部输入。
|
||||
|
||||
```yaml
|
||||
stdin_open: true
|
||||
```
|
||||
|
||||
模拟一个伪终端。
|
||||
|
||||
```yaml
|
||||
tty: true
|
||||
```
|
||||
|
||||
### 11.5.34 读取变量
|
||||
|
||||
Compose 模板文件支持动态读取主机的系统环境变量和当前目录下的 `.env` 文件中的变量。
|
||||
@@ -545,13 +494,11 @@ Compose 模板文件支持动态读取主机的系统环境变量和当前目录
|
||||
例如,下面的 Compose 文件将从运行它的环境中读取变量 `${MONGO_VERSION}` 的值,并写入执行的指令中。
|
||||
|
||||
```yaml
|
||||
|
||||
services:
|
||||
|
||||
db:
|
||||
image: "mongo:${MONGO_VERSION}"
|
||||
```
|
||||
|
||||
如果执行 `MONGO_VERSION=3.2 docker compose up` 则会启动一个 `mongo:3.2` 镜像的容器;如果执行 `MONGO_VERSION=2.8 docker compose up` 则会启动一个 `mongo:2.8` 镜像的容器。
|
||||
|
||||
若当前目录存在 `.env` 文件,执行 `docker compose` 命令时将从该文件中读取变量。
|
||||
@@ -559,10 +506,8 @@ db:
|
||||
在当前目录新建 `.env` 文件并写入以下内容。
|
||||
|
||||
```bash
|
||||
|
||||
## 支持 # 号注释
|
||||
|
||||
MONGO_VERSION=3.6
|
||||
```
|
||||
|
||||
执行 `docker compose up` 则会启动一个 `mongo:3.6` 镜像的容器。
|
||||
|
||||
@@ -30,7 +30,6 @@ flowchart TD
|
||||
Browser["localhost:8000<br/>(浏览器访问)"]
|
||||
Port8000 --> Browser
|
||||
```
|
||||
|
||||
图 11-1:Django + PostgreSQL 的 Compose 架构
|
||||
|
||||
**关键点**:
|
||||
@@ -47,7 +46,6 @@ flowchart TD
|
||||
```bash
|
||||
$ mkdir django-docker && cd django-docker
|
||||
```
|
||||
|
||||
我们需要创建三个文件:`Dockerfile`、`requirements.txt` 和 `compose.yaml`。
|
||||
|
||||
### 11.6.3 步骤 1:创建 Dockerfile
|
||||
@@ -75,7 +73,6 @@ RUN pip install --no-cache-dir -r requirements.txt
|
||||
|
||||
COPY . /code/
|
||||
```
|
||||
|
||||
**逐行解释**:
|
||||
|
||||
| 指令 | 作用 | 为什么这样写 |
|
||||
@@ -95,7 +92,6 @@ Django>=5.0,<6.0
|
||||
psycopg[binary]>=3.1,<4.0
|
||||
gunicorn>=21.0,<22.0
|
||||
```
|
||||
|
||||
**依赖说明**:
|
||||
|
||||
| 包名 | 作用 |
|
||||
@@ -140,7 +136,6 @@ services:
|
||||
volumes:
|
||||
postgres_data:
|
||||
```
|
||||
|
||||
**配置详解**:
|
||||
|
||||
#### db 服务
|
||||
@@ -160,7 +155,6 @@ db:
|
||||
test: ["CMD-SHELL", "pg_isready -U django_user -d django_db"]
|
||||
interval: 5s
|
||||
```
|
||||
|
||||
> ⚠️ **笔者提醒**:`volumes` 配置很重要!没有它,每次容器重启数据都会丢失。笔者见过不少新手因为忘记这一步,导致开发数据全部丢失。
|
||||
|
||||
#### web 服务
|
||||
@@ -179,7 +173,6 @@ web:
|
||||
db:
|
||||
condition: service_healthy # 等待数据库健康后再启动
|
||||
```
|
||||
|
||||
**关键配置说明**:
|
||||
|
||||
| 配置项 | 作用 | 笔者建议 |
|
||||
@@ -195,7 +188,6 @@ web:
|
||||
```bash
|
||||
$ docker compose run --rm web django-admin startproject mysite .
|
||||
```
|
||||
|
||||
**命令解释**:
|
||||
|
||||
- `docker compose run`:运行一次性命令
|
||||
@@ -218,7 +210,6 @@ django-docker/
|
||||
├── asgi.py
|
||||
└── wsgi.py
|
||||
```
|
||||
|
||||
> 💡 **Linux 用户注意**:如果遇到权限问题,执行 `sudo chown -R $USER:$USER .`
|
||||
|
||||
### 11.6.7 步骤 5:配置数据库连接
|
||||
@@ -243,7 +234,6 @@ DATABASES = {
|
||||
|
||||
ALLOWED_HOSTS = ['*']
|
||||
```
|
||||
|
||||
**为什么 HOST 是 `db` 而不是 `localhost`?**
|
||||
|
||||
在 Docker Compose 中,各服务通过服务名相互访问。Docker 内置的 DNS 会将 `db` 解析为 db 服务容器的 IP 地址。这是 Docker Compose 的核心功能之一。
|
||||
@@ -253,7 +243,6 @@ ALLOWED_HOSTS = ['*']
|
||||
```bash
|
||||
$ docker compose up
|
||||
```
|
||||
|
||||
你会看到:
|
||||
|
||||
1. 首先构建 web 镜像 (第一次运行)
|
||||
@@ -266,7 +255,6 @@ db-1 | LOG: database system is ready to accept connections
|
||||
web-1 | Watching for file changes with StatReloader
|
||||
web-1 | Starting development server at http://0.0.0.0:8000/
|
||||
```
|
||||
|
||||
打开浏览器访问 `http://localhost:8000`,可以看到 Django 欢迎页面!
|
||||
|
||||
### 11.6.9 常用开发命令
|
||||
@@ -274,7 +262,6 @@ web-1 | Starting development server at http://0.0.0.0:8000/
|
||||
在另一个终端窗口执行:
|
||||
|
||||
```bash
|
||||
|
||||
## 执行数据库迁移
|
||||
|
||||
$ docker compose exec web python manage.py migrate
|
||||
@@ -291,7 +278,6 @@ $ docker compose exec web python manage.py shell
|
||||
|
||||
$ docker compose exec db psql -U django_user -d django_db
|
||||
```
|
||||
|
||||
> 💡 笔者建议使用 `exec` 而不是 `run`。`exec` 在已运行的容器中执行命令,`run` 会创建新容器。
|
||||
|
||||
### 11.6.10 常见问题排查
|
||||
@@ -307,13 +293,11 @@ $ docker compose exec db psql -U django_user -d django_db
|
||||
| 网络未创建 | 运行 `docker compose down` 后重新 `up` |
|
||||
|
||||
```bash
|
||||
|
||||
## 调试:检查数据库是否正常运行
|
||||
|
||||
$ docker compose ps
|
||||
$ docker compose logs db
|
||||
```
|
||||
|
||||
#### Q2:代码修改没有生效
|
||||
|
||||
**可能原因**:
|
||||
@@ -325,12 +309,10 @@ $ docker compose logs db
|
||||
#### Q3:权限问题
|
||||
|
||||
```bash
|
||||
|
||||
## 如果容器内创建的文件 root 用户所有
|
||||
|
||||
$ sudo chown -R $USER:$USER .
|
||||
```
|
||||
|
||||
### 11.6.11 开发 vs 生产:关键差异
|
||||
|
||||
笔者特别提醒,本节的配置是 **开发环境** 配置。生产环境需要以下调整:
|
||||
@@ -344,7 +326,6 @@ $ sudo chown -R $USER:$USER .
|
||||
| **ALLOWED_HOSTS**| `['*']` | 具体域名 |**生产环境 Compose 文件示例**:
|
||||
|
||||
```yaml
|
||||
|
||||
## compose.prod.yaml
|
||||
|
||||
services:
|
||||
@@ -359,7 +340,6 @@ services:
|
||||
# ...
|
||||
|
||||
```
|
||||
|
||||
### 11.6.12 延伸阅读
|
||||
|
||||
- [Compose 模板文件详解](11.5_compose_file.md):深入理解 Compose 文件的所有配置项
|
||||
|
||||
@@ -30,7 +30,6 @@ flowchart TD
|
||||
Browser["localhost:3000"]
|
||||
Port3000 --> Browser
|
||||
```
|
||||
|
||||
图 11-2:Rails + PostgreSQL 的 Compose 架构
|
||||
|
||||
### 11.7.2 准备工作
|
||||
@@ -40,7 +39,6 @@ flowchart TD
|
||||
```bash
|
||||
$ mkdir rails-docker && cd rails-docker
|
||||
```
|
||||
|
||||
需要创建三个文件:`Dockerfile`、`Gemfile` 和 `compose.yaml`。
|
||||
|
||||
### 11.7.3 步骤 1:创建 Dockerfile
|
||||
@@ -68,7 +66,6 @@ RUN bundle install
|
||||
|
||||
COPY . /myapp
|
||||
```
|
||||
|
||||
**配置说明**:
|
||||
|
||||
| 指令 | 作用 |
|
||||
@@ -86,13 +83,11 @@ COPY . /myapp
|
||||
source 'https://rubygems.org'
|
||||
gem 'rails', '~> 7.1'
|
||||
```
|
||||
|
||||
创建空的 `Gemfile.lock`:
|
||||
|
||||
```bash
|
||||
$ touch Gemfile.lock
|
||||
```
|
||||
|
||||
### 11.7.5 步骤 3:创建 compose.yaml
|
||||
|
||||
配置如下:
|
||||
@@ -121,7 +116,6 @@ services:
|
||||
volumes:
|
||||
postgres_data:
|
||||
```
|
||||
|
||||
**配置详解**:
|
||||
|
||||
| 配置项 | 说明 |
|
||||
@@ -138,7 +132,6 @@ volumes:
|
||||
```bash
|
||||
$ docker compose run --rm web rails new . --force --database=postgresql --skip-bundle
|
||||
```
|
||||
|
||||
**命令解释**:
|
||||
|
||||
- `--rm`:执行后删除临时容器
|
||||
@@ -155,7 +148,6 @@ Gemfile.lock README.md app config.ru log
|
||||
compose.yaml bin db public
|
||||
|
||||
```
|
||||
|
||||
> ⚠️ **Linux 用户**:如遇权限问题,执行 `sudo chown -R $USER:$USER .`
|
||||
|
||||
### 11.7.7 步骤 5:重新构建镜像
|
||||
@@ -165,7 +157,6 @@ compose.yaml bin db public
|
||||
```bash
|
||||
$ docker compose build
|
||||
```
|
||||
|
||||
### 11.7.8 步骤 6:配置数据库连接
|
||||
|
||||
修改 `config/database.yml`:
|
||||
@@ -187,7 +178,6 @@ test:
|
||||
production:
|
||||
<<: *default
|
||||
```
|
||||
|
||||
> 💡 使用 `DATABASE_URL` 环境变量配置数据库,符合 12-factor 应用原则,便于在不同环境间切换。
|
||||
|
||||
### 11.7.9 步骤 7:启动应用
|
||||
@@ -195,7 +185,6 @@ production:
|
||||
```bash
|
||||
$ docker compose up
|
||||
```
|
||||
|
||||
输出示例:
|
||||
|
||||
```bash
|
||||
@@ -207,7 +196,6 @@ web-1 | => Run `bin/rails server --help` for more startup options
|
||||
web-1 | Puma starting in single mode...
|
||||
web-1 | * Listening on http://0.0.0.0:3000
|
||||
```
|
||||
|
||||
### 11.7.10 步骤 8:创建数据库
|
||||
|
||||
在另一个终端执行:
|
||||
@@ -217,13 +205,11 @@ $ docker compose exec web rails db:create
|
||||
Created database 'myapp_development'
|
||||
Created database 'myapp_test'
|
||||
```
|
||||
|
||||
访问 http://localhost:3000 查看 Rails 欢迎页面。
|
||||
|
||||
### 11.7.11 常用开发命令
|
||||
|
||||
```bash
|
||||
|
||||
## 数据库迁移
|
||||
|
||||
$ docker compose exec web rails db:migrate
|
||||
@@ -244,7 +230,6 @@ $ docker compose exec web rails generate scaffold Post title:string body:text
|
||||
|
||||
$ docker compose exec web bash
|
||||
```
|
||||
|
||||
### 11.7.12 常见问题
|
||||
|
||||
#### Q:数据库连接失败
|
||||
@@ -255,7 +240,6 @@ $ docker compose exec web bash
|
||||
$ docker compose ps
|
||||
$ docker compose logs db
|
||||
```
|
||||
|
||||
#### Q:server.pid 文件导致启动失败
|
||||
|
||||
错误信息:`A server is already running`
|
||||
@@ -265,7 +249,6 @@ $ docker compose logs db
|
||||
```bash
|
||||
$ docker compose exec web rm -f tmp/pids/server.pid
|
||||
```
|
||||
|
||||
#### Q:Gem 安装失败
|
||||
|
||||
可能需要更新 bundler 或清理缓存:
|
||||
@@ -273,7 +256,6 @@ $ docker compose exec web rm -f tmp/pids/server.pid
|
||||
```bash
|
||||
$ docker compose run --rm web bundle update
|
||||
```
|
||||
|
||||
### 11.7.13 开发 vs 生产
|
||||
|
||||
| 配置项 | 开发环境 | 生产环境 |
|
||||
|
||||
@@ -13,7 +13,6 @@ wordpress/
|
||||
└── nginx/ # 可选:反向代理配置
|
||||
└── nginx.conf
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 11.8.2 编写 `compose.yaml`
|
||||
@@ -74,7 +73,6 @@ volumes:
|
||||
networks:
|
||||
wp_net:
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 11.8.3 配置文件详解
|
||||
@@ -87,7 +85,6 @@ networks:
|
||||
DB_ROOT_PASSWORD=somestrongrootpassword
|
||||
DB_PASSWORD=somestronguserpassword
|
||||
```
|
||||
|
||||
Compose 会自动读取此同级目录下的文件。
|
||||
|
||||
#### 2. 数据持久化
|
||||
@@ -108,7 +105,6 @@ upload_max_filesize = 64M
|
||||
post_max_size = 64M
|
||||
max_execution_time = 600
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 11.8.4 启动与运行
|
||||
@@ -118,7 +114,6 @@ max_execution_time = 600
|
||||
```bash
|
||||
$ docker compose up -d
|
||||
```
|
||||
|
||||
2. 访问安装界面:
|
||||
打开浏览器访问 `http://localhost:8000`
|
||||
|
||||
@@ -127,7 +122,6 @@ $ docker compose up -d
|
||||
```bash
|
||||
$ docker compose logs -f
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 11.8.5 生产环境最佳实践
|
||||
@@ -137,12 +131,10 @@ $ docker compose logs -f
|
||||
不要只依赖 Volume。建议定期备份数据库:
|
||||
|
||||
```bash
|
||||
|
||||
## 导出 SQL
|
||||
|
||||
$ docker exec wordpress_db mysqldump -u wordpress -pwordpress wordpress > backup.sql
|
||||
```
|
||||
|
||||
或者添加一个自动备份容器:
|
||||
|
||||
```yaml
|
||||
@@ -162,7 +154,6 @@ $ docker exec wordpress_db mysqldump -u wordpress -pwordpress wordpress > backup
|
||||
networks:
|
||||
- wp_net
|
||||
```
|
||||
|
||||
#### 2. 使用 Nginx 反向代理
|
||||
|
||||
在生产环境中,不要直接暴露 WordPress 端口,而是通过 Nginx 进行反向代理并配置 SSL。
|
||||
@@ -178,7 +169,6 @@ WordPress 支持 Redis 缓存以提高性能。
|
||||
networks:
|
||||
- wp_net
|
||||
```
|
||||
|
||||
在 WordPress 容器环境变量中添加:
|
||||
```yaml
|
||||
WORDPRESS_REDIS_HOST: redis
|
||||
@@ -204,7 +194,6 @@ WordPress 支持 Redis 缓存以提高性能。
|
||||
```bash
|
||||
$ docker compose restart wordpress
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 11.8.7 延伸阅读
|
||||
|
||||
Reference in New Issue
Block a user