summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorxinyu <xinyu@nerv.org.cn>2022-08-18 03:44:07 +0800
committerGitHub <noreply@github.com>2022-08-17 15:44:07 -0400
commit208b4ee417c528f11583bb84f3f3481bfad12ac7 (patch)
treedb0b20167796a080048ec4514dbf3c20379cbde6 /docs
parent87ca739a3f70b4e7e298f65630533499fc101259 (diff)
downloadgitea-208b4ee417c528f11583bb84f3f3481bfad12ac7.tar.gz
gitea-208b4ee417c528f11583bb84f3f3481bfad12ac7.zip
docs[zh-cn]: Managing Deployments With Environment Variables (#20817)
Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/content/doc/installation/with-docker.zh-cn.md58
1 files changed, 47 insertions, 11 deletions
diff --git a/docs/content/doc/installation/with-docker.zh-cn.md b/docs/content/doc/installation/with-docker.zh-cn.md
index 91892fdaf9..2c63c9d4e1 100644
--- a/docs/content/doc/installation/with-docker.zh-cn.md
+++ b/docs/content/doc/installation/with-docker.zh-cn.md
@@ -23,7 +23,7 @@ Gitea 在其 Docker Hub 组织内提供自动更新的 Docker 镜像。可以始
## 基本
-最简单的设置只是创建一个卷和一个网络,然后将 `gitea/gitea:latest` 镜像作为服务启动。由于没有可用的数据库,因此可以使用 SQLite3 初始化数据库。创建一个类似 `gitea` 的目录,并将以下内容粘贴到名为 `docker-compose.yml` 的文件中。请注意,该卷应由配置文件中指定的 UID/GID 的用户/组拥有。如果您不授予卷正确的权限,则容器可能无法启动。另请注意,标签 `:latest` 将安装当前的开发版本。对于稳定的发行版,您可以使用 `:1` 或指定某个发行版,例如 `:1.13.0`。
+最简单的设置只是创建一个卷和一个网络,然后将 `gitea/gitea:latest` 镜像作为服务启动。由于没有可用的数据库,因此可以使用 SQLite3 初始化数据库。创建一个类似 `gitea` 的目录,并将以下内容粘贴到名为 `docker-compose.yml` 的文件中。请注意,该卷应由配置文件中指定的 UID/GID 的用户/组拥有。如果您不授予卷正确的权限,则容器可能无法启动。另请注意,标签 `:latest` 将安装当前的开发版本。对于稳定的发行版,您可以使用 `:1` 或指定某个发行版,例如 `{{< version >}}`。
```yaml
version: "3"
@@ -103,11 +103,11 @@ services:
environment:
- USER_UID=1000
- USER_GID=1000
-+ - DB_TYPE=mysql
-+ - DB_HOST=db:3306
-+ - DB_NAME=gitea
-+ - DB_USER=gitea
-+ - DB_PASSWD=gitea
++ - GITEA__database__DB_TYPE=mysql
++ - GITEA__database__HOST=db:3306
++ - GITEA__database__NAME=gitea
++ - GITEA__database__USER=gitea
++ - GITEA__database__PASSWD=gitea
restart: always
networks:
- gitea
@@ -153,11 +153,11 @@ services:
environment:
- USER_UID=1000
- USER_GID=1000
-+ - DB_TYPE=postgres
-+ - DB_HOST=db:5432
-+ - DB_NAME=gitea
-+ - DB_USER=gitea
-+ - DB_PASSWD=gitea
++ - GITEA__database__DB_TYPE=postgres
++ - GITEA__database__HOST=db:5432
++ - GITEA__database__NAME=gitea
++ - GITEA__database__USER=gitea
++ - GITEA__database__PASSWD=gitea
restart: always
networks:
- gitea
@@ -276,6 +276,42 @@ docker-compose pull
docker-compose up -d
```
+## 使用环境变量管理部署
+
+除了上面的环境变量之外,`app.ini` 中的任何设置都可以使用以下形式的环境变量进行设置或覆盖:`GITEA__SECTION_NAME__KEY_NAME`。 每次 docker 容器启动时都会应用这些设置。 完整信息在[这里](https://github.com/go-gitea/gitea/tree/master/contrib/environment-to-ini)。
+
+```bash
+...
+services:
+ server:
+ environment:
+ - GITEA__mailer__ENABLED=true
+ - GITEA__mailer__FROM=${GITEA__mailer__FROM:?GITEA__mailer__FROM not set}
+ - GITEA__mailer__MAILER_TYPE=smtp
+ - GITEA__mailer__HOST=${GITEA__mailer__HOST:?GITEA__mailer__HOST not set}
+ - GITEA__mailer__IS_TLS_ENABLED=true
+ - GITEA__mailer__USER=${GITEA__mailer__USER:-apikey}
+ - GITEA__mailer__PASSWD="""${GITEA__mailer__PASSWD:?GITEA__mailer__PASSWD not set}"""
+```
+
+Gitea 将为每次新安装自动生成新的 `SECRET_KEY` 并将它们写入 `app.ini`。 如果您想手动设置 `SECRET_KEY`,您可以使用以下 docker 命令来使用 Gitea 内置的[方法](https://docs.gitea.io/en-us/command-line/#generate)生成 `SECRET_KEY`。 安装后请妥善保管您的 `SECRET_KEY`,如若丢失则无法解密已加密的数据。
+
+以下命令将向 `stdout` 输出一个新的 `SECRET_KEY` 和 `INTERNAL_TOKEN`,然后您可以将其放入环境变量中。
+
+```bash
+docker run -it --rm gitea/gitea:1 gitea generate secret SECRET_KEY
+docker run -it --rm gitea/gitea:1 gitea generate secret INTERNAL_TOKEN
+```
+
+```yaml
+...
+services:
+ server:
+ environment:
+ - GITEA__security__SECRET_KEY=[value returned by generate secret SECRET_KEY]
+ - GITEA__security__INTERNAL_TOKEN=[value returned by generate secret INTERNAL_TOKEN]
+```
+
## SSH 容器直通
由于 SSH 在容器内运行,因此,如果需要 SSH 支持,则需要将 SSH 从主机传递到容器。一种选择是在非标准端口上运行容器 SSH(或将主机端口移至非标准端口)。另一个可能更直接的选择是将 SSH 连接从主机转发到容器。下面将说明此设置。