docs: 更新版本信息

This commit is contained in:
2023-08-03 11:06:38 +08:00
parent 443c94c555
commit e2c6e643bb
+10 -40
View File
@@ -8,30 +8,25 @@
**版本信息:**
- 1.18、latest
- 1.16
- 1.20.2、latest
**镜像信息:**
* 镜像地址:
- Aliyun仓库:registry.cn-shenzhen.aliyuncs.com/colovu/nginx
- DockerHubcolovu/nginx
* 依赖镜像:debian:buster-slim
> 后续相关命令行默认使用`[Docker Hub](https://hub.docker.com)`镜像服务器做说明
- 阿里云: registry.cn-shenzhen.aliyuncs.com/colovu/nginx:latest
- DockerHubcolovu/nginx:latest
- Colovu Registry: docker.colovu.com/colovu/nginx:latest
- 依赖镜像:colovu/debian:12
> 后续相关命令行默认使用`[Colovu Registry](https://docker.colovu.com)`镜像服务器做说明
## TL;DR
Docker 快速启动命令:
```shell
# 从 Docker Hub 服务器下载镜像并启动
$ docker run -d -p 80:8080 colovu/nginx
# 从 Aliyun 服务器下载镜像并启动
$ docker run -d -p 80:8080 registry.cn-shenzhen.aliyuncs.com/colovu/nginx
# 从 Registry 服务器下载镜像并启动
$ docker run -d -p 80:8080 docker.colovu.com/colovu/nginx:latest
```
启动后,可以使用浏览器访问:`http://localhost/`,出现默认的 Nginx 首页。
@@ -51,12 +46,8 @@ $ curl -sSL -o https://raw.githubusercontent.com/colovu/docker-nginx/master/dock
$ docker-compose up -d
```
---
## 默认对外声明
### 端口
@@ -77,18 +68,14 @@ $ docker-compose up -d
如果需要持久化存储相应数据,需要**在宿主机建立本地目录**,并在使用镜像初始化容器时进行映射。宿主机相关的目录中如果不存在对应应用`nginx`的子目录或相应数据文件,则容器会在初始化时创建相应目录及文件。
## 容器配置
在初始化 `Nginx` 容器时,如果没有预置配置文件,可以在命令行中设置相应环境变量对默认参数进行修改。类似命令如下(配置环境变量`APP_ENV_KEY_NAME`的值为`key_value`):
```shell
$ docker run -d -e "APP_ENV_KEY_NAME=key_value" colovu/nginx
$ docker run -d -e "APP_ENV_KEY_NAME=key_value" docker.colovu.com/colovu/nginx:latest
```
### 自动变量替换
针对配置文件中的配置项,支持环境变量名自动替换,该类环境变量定义规则为:`APP_CFG_*=<val>`
@@ -119,40 +106,30 @@ max_wal_size = '400MB'
+ `__` ==> `.` : 环境变量中的`双下划线`会被转义为设置属性中的`半角点`
+ `___` ==> `-` : 环境变量中的`三下划线`会被转义为设置属性中的`中划线`
### 常规配置参数
常规配置参数用来配置容器基本属性,一般情况下需要设置,主要包括:
-
### 常规可选参数
如果没有必要,可选配置参数可以不用定义,直接使用对应的默认值,主要包括:
- `ENV_DEBUG`:默认值:**false**。设置是否输出容器调试信息。可选值:no、true、yes
### 集群配置参数
配置服务为集群工作模式时,通过以下参数进行配置:
-
### TLS配置参数
配置服务使用 TLS 加密时,通过以下参数进行配置:
-
## 安全
### 容器安全
@@ -166,20 +143,13 @@ max_wal_size = '400MB'
如果需要切换为`root`方式运行应用,可以在启动命令中增加`-u root`以指定运行的用户。
## 注意事项
- 容器中应用的启动参数不能配置为后台运行,如果应用使用后台方式运行,则容器的启动命令会在运行后自动退出,从而导致容器退出
## 更新记录
- 2021/1/14(1.18): 更新为 Nginx 1.18.0
- 2021/1/1 (1.16): 初始版本,基于 Nginx 1.16.1
- 2023/8/3: 更新为 Nginx 1.20.2
----