glyptodon/guacamole-db-mysql

glyptodon/guacamole-db-mysql 镜像文档

镜像概述和主要用途

Glyptodon Enterprise 提供 http://guacamole.apache.org/ 的软件包，遵循最佳实践，接收定期更新并提供商业支持。本镜像（glyptodon/guacamole-db-mysql）是Docker化的MySQL部署，基于https://hub.docker.com/_/mysql%E6%9E%84%E5%BB%BA%EF%BC%8C%E8%87%AA%E5%8A%A8%E5%88%9D%E5%A7%8B%E5%8C%96Apache Guacamole数据库模式。它使用Glyptodon Enterprise提供的软件包构建，并根据相同的最终用户许可协议(EULA)提供。通常用于为使用glyptodon/guacamole镜像的容器提供MySQL数据库。

核心功能和特性

• 自动初始化：预配置Apache Guacamole所需的数据库 schema，无需手动执行初始化脚本
• 基于官方镜像：继承Docker官方MySQL镜像的所有功能和安全性
• 最小权限原则：为Guacamole创建专用数据库用户，仅授予必要权限
• 灵活配置：支持环境变量和Docker密钥两种配置方式，适应不同部署需求
• 与Glyptodon生态集成：无缝配合glyptodon/guacamole和glyptodon/guacd镜像构建完整部署

使用场景和适用范围

• Glyptodon Enterprise的Docker化部署环境
• 需要为Apache Guacamole提供专用MySQL数据库的场景
• 追求自动化部署和最小权限安全原则的企业环境
• 使用Docker Compose编排多容器Guacamole部署的场景

使用方法和配置说明

启动Guacamole数据库实例

要启动一个自动初始化为Apache Guacamole使用的MySQL实例：

shell
docker run --name some-guacamole-db \
    -e ACCEPT_EULA=Y \
    -e MYSQL_RANDOM_ROOT_PASSWORD=yes \
    -e GUACAMOLE_DATABASE=guacamole_db \
    -e GUACAMOLE_USERNAME=guacamole_user \
    -e GUACAMOLE_PASSWORD=guacamole_password \
    -d docker.xuanyuan.run/glyptodon/guacamole-db-mysql

其中：

• some-guacamole-db 是你希望分配给容器的名称
• guacamole_db 是MySQL中应创建的数据库名称
• guacamole_user 和 guacamole_password 是Guacamole用于认证MySQL的凭据

使用docker-compose（推荐）

使用Docker Compose部署Glyptodon Enterprise非常推荐，因为它可以极大地帮助编排多个容器。以下是一个完整的Glyptodon Enterprise部署示例，使用自动初始化的MySQL数据库进行认证：

yaml
version: "3"
services:

    guacd:
        image: docker.xuanyuan.run/glyptodon/guacd
        environment:
            ACCEPT_EULA: Y

    db:
        image: docker.xuanyuan.run/glyptodon/guacamole-db-mysql
        environment:
            ACCEPT_EULA: Y
            MYSQL_RANDOM_ROOT_PASSWORD: "yes"
            GUACAMOLE_DATABASE: guacamole_db
            GUACAMOLE_USERNAME: guacamole_user
            GUACAMOLE_PASSWORD: some_password

    guacamole:
        image: docker.xuanyuan.run/glyptodon/guacamole
        ports:
            - "8080:8080"
        environment:
            ACCEPT_EULA: Y
            GUACD_HOSTNAME: guacd
            MYSQL_HOSTNAME: db
            MYSQL_DATABASE: guacamole_db
            MYSQL_USERNAME: guacamole_user
            MYSQL_PASSWORD: some_password

环境变量

除下文记录的环境变量外，本镜像还接受官方Docker MySQL镜像支持的所有环境变量，因为官方MySQL镜像是本镜像的基础。

ACCEPT_EULA

必须设置为"Y"以表示您接受Glyptodon Enterprise EULA。本Docker镜像只能在EULA条款下使用。

GUACAMOLE_DATABASE

要创建并初始化为Apache Guacamole使用的数据库名称。此环境变量是必需的，最终映射到官方MySQL镜像的MYSQL_DATABASE环境变量。

提供GUACAMOLE_DATABASE变量是为了与其他Guacamole特定变量保持一致性，但如果提供了MYSQL_DATABASE，则可以省略此变量。

GUACAMOLE_USERNAME 和 GUACAMOLE_PASSWORD

用于Guacamole Web应用程序的MySQL数据库用户的用户名和密码。这对变量与官方MySQL镜像提供的MYSQL_USER和MYSQL_PASSWORD环境变量的不同之处在于，创建的用户具有有限的权限，仅被授予Guacamole运行所需的绝对必要权限。

GUACAMOLE_USERNAME和GUACAMOLE_PASSWORD并非严格必需，因为可以使用MYSQL_USER和MYSQL_PASSWORD创建的用户代替，但强烈建议使用它们以确保遵循最小权限原则。

Docker密钥

除了直接在环境变量中传递数据外，可以为任何支持的环境变量添加_FILE后缀，强制从容器内的指定文件读取该变量。由于Docker密钥将敏感数据存储在容器内/run/secrets/下的文件中，因此可用于从Docker密钥加载敏感数据。

例如，从Docker密钥加载Guacamole Web应用程序专用的有限权限用户的用户名和密码：

shell
docker run --name some-guacamole-db \
    -e ACCEPT_EULA=Y \
    -e MYSQL_RANDOM_ROOT_PASSWORD=yes \
    -e GUACAMOLE_DATABASE=guacamole_db \
    -e GUACAMOLE_USERNAME_FILE=/run/secrets/mysql-username \
    -e GUACAMOLE_PASSWORD_FILE=/run/secrets/mysql-password \
    -d docker.xuanyuan.run/glyptodon/guacamole-db-mysql

许可协议

本Docker镜像仅根据Glyptodon Enterprise EULA的条款提供。通过向环境变量ACCEPT_EULA传递值"Y"，表示您拥有Glyptodon Enterprise的有效现有许可，并接受您对本Docker镜像的使用受这些条款约束。