原文地址：https://docs.konghq.com/install/docker/

有关如何在Docker中使用Kong的详细信息可以在镜像图像的DockerHub存储库中找到：kong。
我们还有一个Docker Compose template，内置编排和可扩展性。

使用数据库

这是一个快速示例，显示如何将Kong容器连接到Cassandra或PostgreSQL容器。

  1. 创建一个Docker network
    您需要创建一个自定义网络，以允许容器相互发现和通信。在此示例中，kong-net是网络名称，您可以使用任何名称。

    1
    $ docker network create kong-net

  2. 启动数据库
    如果您想使用Cassandra容器：

    1
    2
    3
    4
    $ docker run -d --name kong-database \
              --network=kong-net \
              -p 9042:9042 \
              cassandra:3

    如果您想使用PostgreSQL容器：

    1
    2
    3
    4
    5
    6
    $ docker run -d --name kong-database \
              --network=kong-net \
              -p 5432:5432 \
              -e "POSTGRES_USER=kong" \
              -e "POSTGRES_DB=kong" \
              postgres:9.6

  3. 准备数据库
    使用临时Kong容器运行迁移：

    1
    2
    3
    4
    5
    6
    $ docker run --rm \
    --network=kong-net \
    -e "KONG_DATABASE=postgres" \
    -e "KONG_PG_HOST=kong-database" \
    -e "KONG_CASSANDRA_CONTACT_POINTS=kong-database" \
    kong:latest kong migrations bootstrap

    在上面的示例中，配置了Cassandra和PostgreSQL，但您应该使用cassandra或postgres更新KONG_DATABASE环境变量。
    对于Kong 小于0.15的注意事项：如果Kong版本低于0.15（最高0.14），请使用up子命令而不是bootstrap。另请注意，如果Kong 版本小于0.15，则不应同时进行迁移;只有一个Kong节点应该一次执行迁移。对于0.15,1.0及以上的Kong，此限制被取消。

  4. 启动Kong
    迁移运行并且数据库准备就绪后，启动一个将连接到数据库容器的Kong容器，就像临时迁移容器一样：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    $ docker run -d --name kong \
    --network=kong-net \
    -e "KONG_DATABASE=postgres" \
    -e "KONG_PG_HOST=kong-database" \
    -e "KONG_CASSANDRA_CONTACT_POINTS=kong-database" \
    -e "KONG_PROXY_ACCESS_LOG=/dev/stdout" \
    -e "KONG_ADMIN_ACCESS_LOG=/dev/stdout" \
    -e "KONG_PROXY_ERROR_LOG=/dev/stderr" \
    -e "KONG_ADMIN_ERROR_LOG=/dev/stderr" \
    -e "KONG_ADMIN_LISTEN=0.0.0.0:8001, 0.0.0.0:8444 ssl" \
    -p 8000:8000 \
    -p 8443:8443 \
    -p 8001:8001 \
    -p 8444:8444 \
    kong:latest

  5. 使用Kong
    Kong正在运行：

    1
    $ curl -i http://localhost:8001/

    通过5分钟的快速入门快速学习如何使用Kong。

无数据库模式

在无DB模式下启动Kong所涉及的步骤如下：

  1. 创建一个Docker network
    这与Pg / Cassandra指南中的相同。我们也使用kong-net作为网络名称，它也可以改为其他东西。

    1
    $ docker network create kong-net

    在无DB模式下运行Kong并不严格需要此步骤，但如果您希望将来添加其他内容（如Redis群集备份的速率限制插件），这是一个很好的预防措施。

  2. 创建Docker volume

    对于本指南的目的，Docker卷是主机内的一个文件夹，可以将其映射到容器中的文件夹中。卷有一个名称。在这种情况下，我们将命名我们的kong-vol

    1
    $ docker volume create kong-vol

    您现在应该能够检查volume：

    1
    $ docker volume inspect kong-vol

    结果应该类似于：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
       [
           {
               "CreatedAt": "2019-05-28T12:40:09Z",
               "Driver": "local",
               "Labels": {},
               "Mountpoint": "/var/lib/docker/volumes/kong-vol/_data",
               "Name": "kong-vol",
               "Options": {},
               "Scope": "local"
           }
    ]

    注意MountPoint条目。我们将在下一步中使用该路径。

  3. 准备声明性配置文件

    声明性配置格式指南中描述了语法和属性。

    添加您需要的任何核心实体（服务，路由，插件，消费者等）。

    在本指南中，我们假设您将其命名为kong.yml。

    将其保存在上一步中提到的MountPoint路径中。

    就本指南而言，这将是/var/lib/docker/volumes/kong-vol/_data/kong.yml

  4. 在无DB模式中启动Kong

    虽然可以仅使用KONG_DATABASE=off来启动Kong容器，但通常还需要通过KONG_DECLARATIVE_CONFIG变量名称将声明性配置文件作为参数包含在内。为此，我们需要从容器中使文件“visible”。我们使用-v标志来实现这一点，它将kong-vol卷映射到容器中的/usr/local/kong/declarative文件夹。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    $ docker run -d --name kong \
    --network=kong-net \
    -v "kong-vol:/usr/local/kong/declarative" \
    -e "KONG_DATABASE=off" \
    -e "KONG_DECLARATIVE_CONFIG=/usr/local/kong/declarative/kong.yml" \
    -e "KONG_PROXY_ACCESS_LOG=/dev/stdout" \
    -e "KONG_ADMIN_ACCESS_LOG=/dev/stdout" \
    -e "KONG_PROXY_ERROR_LOG=/dev/stderr" \
    -e "KONG_ADMIN_ERROR_LOG=/dev/stderr" \
    -e "KONG_ADMIN_LISTEN=0.0.0.0:8001, 0.0.0.0:8444 ssl" \
    -p 8000:8000 \
    -p 8443:8443 \
    -p 8001:8001 \
    -p 8444:8444 \
    kong:latest

  5. 使用Kong

    Kong应该正在运行，它应该包含一些以Kong .yml添加的实体。

    1
    $ curl -i http://localhost:8001/

    例如，获取服务列表：

    1
    $ curl -i http://localhost:8001/services