配置 Discourse - 环境 AWS Linux 2 AMI 和 Apache2 (httpd)

Matthew_Lucas · 2023 年7 月 7 日 17:51

在已有 HTTPD 反向代理的 AWS EC2 Linux 上安装 Docker 和 Discourse

大家好，

我已经解决了问题。我重新从头开始，进行了干净的 Docker 和 Discourse 安装。我的具体步骤如下：

前提假设

• 您已拥有一个 AWS EC2 Linux 实例
• 您可以通过 SSH 访问该 EC2 实例
• Apache 2 已在您的服务器上配置并运行

通过 SSH 访问您的 EC2 实例

打开 CMD / 终端
通过 SSH 登录到 AWS EC2 实例

连接到 EC2 实例后的屏幕示例

执行系统更新

在控制台/终端中运行以下命令执行系统更新

$ sudo yum update

安装 Docker

在控制台/终端中运行以下命令搜索 AWS Docker 软件包

$ sudo yum search docker

在控制台/终端中运行以下命令获取版本信息

$ sudo yum info docker

在控制台/终端中运行以下命令安装 Docker

$ sudo yum install docker

在控制台/终端中运行以下命令为默认的 ec2-user 添加组 membership，以便您可以无需使用 sudo 命令即可运行所有 Docker 命令

$ sudo usermod -a -G docker ec2-user
$ id ec2-user

# 无需注销即可重新加载 Linux 用户的 Docker 组分配

$ newgrp docker

在控制台/终端中运行以下命令安装 docker-compose

# 1. 获取 pip3（Python 安装包）
$ sudo yum install python3-pip
 
# 2. 然后运行以下任意一条命令
$ sudo pip3 install docker-compose # 使用 root 权限
 
# 或
 
$ pip3 install --user docker-compose # 出于安全原因不使用 root 权限

# 检查权限
$ sudo chmod -v +x /usr/local/bin/docker-compose

在控制台/终端中运行以下命令启用 Docker 服务，使其在启动时自动运行

$ sudo systemctl enable docker.service

在控制台/终端中运行以下命令启动 Docker 服务

$ sudo systemctl start docker.service

在控制台/终端中运行以下命令检查 Docker 服务是否正在运行，输出将类似于以下内容

一些有用的基础 Docker 命令：

# Docker 版本
$ docker version

# Docker Compose 版本
$ docker-compose version

# 启动 Docker 服务
$ sudo systemctl start docker.service

# 停止 Docker 服务
$ sudo systemctl stop docker.service

# 重启 Docker 服务
$ sudo systemctl restart docker.service

# Docker 服务状态
$ sudo systemctl status docker.service

安装 Discourse

创建 Discourse 文件夹

$ sudo mkdir /var/discourse

将 Discourse Docker 镜像克隆到新创建的目录

$ sudo git clone https://github.com/discourse/discourse_docker.git /var/discourse

将 standalone.yml 文件复制到 containers 文件夹

$ cp /var/discourse/samples/standalone.yml /var/discourse/containers/discourse.yml

按如下方式编辑新的 discourse.yml 文件（重要部分包括 HTTP 的暴露端口和 SMTP 的电子邮件详情，请在文件中修改，不要直接复制粘贴）

编辑选项：

1. 您可以使用 nano 并通过命令行/终端进行编辑
2. 在 AWS 上，如果您使用带有 PLUMA 的 MATE 桌面环境，可以使用 PLUMA 编辑文件
3. 您可以使用 WINSCP 通过 SSH 登录到机器，并通过 Windows GUI 编辑文件

## 这是全功能的独立 Discourse Docker 容器模板
##
## 修改此文件后，您必须重新构建
## /var/discourse/launcher rebuild app
##
## 编辑时请*非常*小心！
## YAML 文件对空格或缩进错误极其敏感！
## 如有需要，请访问 http://www.yamllint.com/ 验证此文件

templates:
  - "templates/postgres.template.yml"
  - "templates/redis.template.yml"
  - "templates/web.template.yml"
  ## 取消注释下一行以启用 IPv6 监听器
  #- "templates/web.ipv6.template.yml"
  - "templates/web.ratelimited.template.yml"
  ## 如果您想添加 Lets Encrypt (https)，请取消注释这两行
  #- "templates/web.ssl.template.yml"
  #- "templates/web.letsencrypt.ssl.template.yml"

## 此容器应暴露哪些 TCP/IP 端口？
## 如果您希望 Discourse 与另一个 Web 服务器（如 Apache 或 nginx）共享端口，
## 请参阅 https://meta.discourse.org/t/17247 了解详情
expose:
  - "8080:80"   # http（在本地端口 8080 运行，Docker 端口为 80）
  #- "443:443" # https（请确保此行已注释）

params:
  db_default_text_search_config: "pg_catalog.english"

  ## 将 db_shared_buffers 设置为总内存的最大 25%。
  ## 将根据检测到的 RAM 自动设置，您也可以覆盖
  #db_shared_buffers: "256MB"

  ## 可以提高排序性能，但会增加每个连接的内存使用量
  #db_work_mem: "40MB"

  ## 此容器应使用哪个 Git 修订版本？（默认：tests-passed）
  #version: tests-passed

env:
  LC_ALL: en_US.UTF-8
  LANG: en_US.UTF-8
  LANGUAGE: en_US.UTF-8
  # DISCOURSE_DEFAULT_LOCALE: en

  ## 支持多少并发 Web 请求？取决于内存和 CPU 核心数。
  ## 将根据检测到的 CPU 自动设置，您也可以覆盖
  #UNICORN_WORKERS: 3

  ## TODO: 此 Discourse 实例将响应的域名
  ## 必填项。Discourse 无法仅使用裸 IP 地址运行。
  DISCOURSE_HOSTNAME: 'faq.mobiloan.io'

  ## 如果您希望容器以与上述相同的 hostname（-h 选项）启动，请取消注释
  #DOCKER_USE_HOSTNAME: true

  ## TODO: 初始注册时将设为管理员和开发者的逗号分隔电子邮件列表
  ## 示例：'user1@example.com,user2@example.com'
  DISCOURSE_DEVELOPER_EMAILS: ‘在此输入电子邮件’

  ## TODO: 用于验证新账户和发送通知的 SMTP 邮件服务器
  # SMTP 地址、用户名和密码为必填项
  # 警告：SMTP 密码中的字符 '#' 可能导致问题！
  DISCOURSE_SMTP_ADDRESS: 在此输入 SMTP 地址
  DISCOURSE_SMTP_PORT: 587
  DISCOURSE_SMTP_USER_NAME: 在此输入用户名
  DISCOURSE_SMTP_PASSWORD: 在此输入密码
  DISCOURSE_SMTP_ENABLE_START_TLS: true           # （可选，默认为 true，我们使用 Amazon SES）

 

  #DISCOURSE_SMTP_DOMAIN: discourse.example.com    # （某些提供商要求）
  #DISCOURSE_NOTIFICATION_EMAIL: noreply@discourse.example.com    # （发送通知的地址）

  ## 如果您添加了 Lets Encrypt 模板，请取消注释以下行以获取免费 SSL 证书
  #LETSENCRYPT_ACCOUNT_EMAIL: me@example.com

  ## 此 Discourse 实例的 HTTP 或 HTTPS CDN 地址（配置为拉取）
  ## 请参阅 https://meta.discourse.org/t/14857 了解详情
  #DISCOURSE_CDN_URL: https://discourse-cdn.example.com
  
  ## MaxMind 地理位置 IP 地址查询的许可证密钥
  ## 请参阅 https://meta.discourse.org/t/-/137387/23 了解详情
  #DISCOURSE_MAXMIND_LICENSE_KEY: 1234567890123456

## Docker 容器是无状态的；所有数据都存储在 /shared 中
volumes:
  - volume:
      host: /var/discourse/shared/standalone
      guest: /shared
  - volume:
      host: /var/discourse/shared/standalone/log/var-log
      guest: /var/log

## 插件放在此处
## 请参阅 https://meta.discourse.org/t/19157 了解详情
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git

## 构建后运行的任何自定义命令
run:
  - exec: echo "开始自定义命令"
  ## 如果您想设置首次注册的'From'电子邮件地址，请取消注释并修改：
  ## 收到首次注册邮件后，请重新注释该行。该行只需运行一次。
  #- exec: rails r "SiteSetting.notification_email='info@unconfigured.discourse.org'"
  - exec: echo "结束自定义命令"

文件编辑并保存后，在终端中运行以下命令重新构建 Discourse 应用

$ /var/discourse/launcher rebuild discourse

注意：如果您的 yaml 文件名称不同，请将 discourse 替换为您的 yaml 文件名

请注意，重新构建需要一些时间。

应用重新构建完成后，应用应运行在 8080 端口。要验证这一点，请在终端中运行以下命令

$ sudo lsof -i -P -n | grep LISTEN

端口输出示例

注意：Docker 监听 8080 端口，httpd（Apache）监听 80 端口。

在流量路由方面，Apache 将接收 Web 请求，并在适当时将其路由到 8080 端口的 Discourse 容器。

为了确保路由正常，您必须在 Apache 配置文件中配置虚拟主机。

Apache 虚拟主机配置

Apache 配置文件位于 /etc/httpd/conf.d/00-virtualhosts.conf。httpd / apache / apache2 是不同版本的 Apache。如果您未使用 httpd 服务，您的文件可能位于不同位置，但虚拟主机配置在此情况下是相同的。

编辑选项：

1. 您可以使用 nano 并通过命令行/终端进行编辑
2. 在 AWS 上，如果您使用带有 PLUMA 的 MATE 桌面环境，可以使用 PLUMA 编辑文件
3. 您可以使用 WINSCP 通过 SSH 登录到机器，并通过 Windows GUI 编辑文件

通过添加以下内容编辑 /etc/httpd/conf.d/00-virtualhosts.conf 文件：

# FAQ（DISCOURSE 路由）

<VirtualHost *:80>
  	ServerName  sub.domain.com
  	ProxyPreserveHost On
    ProxyPass "/" "http://localhost:8080/"
    ProxyPassReverse "/" "http://localhost:8080/"
</VirtualHost>

您需要创建相应的 CNAME DNS 记录，将子域名指向您的 AWS 服务器/负载均衡器。

我们的设置稍微复杂一些，因为我们有域名提供商，它将所有流量路由到 AWS 负载均衡器。

负载均衡器通过 AWS 提供的证书处理我们的 SSL/TLS。

负载均衡器还将流量路由到 AWS 实例。

Apache 安装在 AWS 实例上，并将流量路由到我们的：

Node Express 应用程序
Docker / Discourse 应用程序。

结论

这只是其中一种解决方案，但它是与我们现有设置兼容的解决方案。

特别感谢：

@Kane York 关于 Discourse 的文章，
@Axel Fernandes 在 Medium 上的文章及其关于下载必要 Discourse 文件的笔记，
@Vivek Gite 来自 nixCraft 以及他在 cyberciti 上关于在 AWS Linux 2 上安装 Docker 的文章。

话题		回复	浏览量
Discourse not loading with Apache and proxy redirect Self-hosting	7	2628	2020 年7 月 15 日
Domain names pointing with shared AWS instance Self-hosting	20	2849	2018 年5 月 16 日
How to install Discourse in the AWS EC2 Instances(Ubuntu Server LTS)? Self-hosting	36	5388	2019 年3 月 30 日
Fresh install returning 502 Bad Gateway Self-hosting unsupported-install	27	1259	2024 年3 月 12 日
Installation on v-server as a subfolder with other services in subfolders using apache Self-hosting	39	8522	2016 年7 月 6 日

配置 Discourse - 环境 AWS Linux 2 AMI 和 Apache2 (httpd)

相关话题