ibmcom/cloudant-developer

!Cloudant 镜像

重要更新：已弃用

Cloudant开发者版已不再维护。建议使用最新的https://hub.docker.com/_/couchdb%E9%95%9C%E5%83%8F%E8%BF%9B%E8%A1%8CIBM Cloudant的本地开发。参见IBM Cloudant文档中的IBM Cloudant与Apache CouchDB对比。

什么是Cloudant开发者版？

Cloudant开发者版有以下限制：

• 单节点实例，无集群能力
• 仅许可用于开发目的

入门

下载并安装Docker。建议使用1.9或更高版本以利用命名卷功能。

Docker安装完成后，从Docker Hub拉取镜像：

docker pull ibmcom/cloudant-developer

启动Cloudant开发者版容器

使用docker启动容器，运行以下命令：

docker run \
       --detach \
       --volume cloudant:/srv \
       --name cloudant-developer \
       --publish 8080:80 \
       --hostname cloudant.dev \
       ibmcom/cloudant-developer

通过Docker Compose启动容器，创建docker-compose.yml文件，内容如下：

version: '3'
services:

  cloudant-developer:
    build:
      context: .
    image: ibmcom/cloudant-developer:latest
    container_name: cloudant-developer
    hostname: developer.local
    ports:
      - "8080:80"
    volumes:
      - cloudant-developer:/srv
    network_mode: bridge

volumes:
  cloudant-developer:

在创建docker-compose.yml文件的目录中，运行以下命令启动容器：

docker-compose pull
docker-compose up -d

最终用户许可

本镜像仅许可用于开发目的，不得用于生产环境。请查看/接受最终用户许可协议。

注意： 下载并运行本实例即表示您同意上述许可协议的所有条款和条件。

Cloudant仪表盘

要访问Cloudant仪表盘，在浏览器中输入以下URL：http://localhost:8080/dashboard.html。默认登录凭据为：

• 用户名 = admin
• 密码 = pass

注意： 如果在Mac OS X或Windows上运行Docker（Docker在虚拟机中运行），需将URL中的localhost替换为Docker虚拟机的IP地址。

支持的Docker版本

本镜像官方支持Docker 1.11.0版本。 对旧版本（低至1.9）的支持基于尽力而为原则。 有关如何升级Docker守护程序的详细信息，请参见Docker安装文档。

附加信息

有关使用Cloudant API的更多信息，请参见在线文档。对于技术问题，请在StackOverflow上搜索Cloudant。如果未找到答案，请使用标签“cloudant”发布问题。

许可证

Dockerfile和相关脚本根据Apache License 2.0许可。Cloudant-developer根据IBM International License Agreement for Non-Warranted Programs许可。Cloudant开发者版的此许可可在在线查看。请注意，此许可不允许进一步分发。

从1.x升级

从1.x版本升级时，以下变更适用：

1. 不再需要/可以以特权模式运行容器。
2. 启动容器前不再需要接受许可。
3. 不再需要手动初始化数据库/卷。

常见问题（FAQs）

Q1. 如何查看容器日志文件？
A1. 在终端窗口运行以下命令：

docker logs cloudant-developer

Q2. 我通过VirtualBox在Mac或Windows上运行Docker。如何查找Docker虚拟机的IP地址？
A2. 在终端窗口运行以下命令：

docker-machine ls

Q3. 尝试通过浏览器启动仪表盘时，只看到部分屏幕，没有登录提示。
A3. 您可能首次未初始化数据。

Q4. 如何在不同端口上运行容器？
A4. 更改docker run命令的**--publish选项值。例如，要在端口80上运行，docker run命令的选项应为--publish 80:80**。

Q5. 为什么升级时遇到问题？
A5. 可能是由于旧版本Cloudant Developer遗留的不兼容卷导致。尝试删除这些卷：

bash
docker volume rm cloudant

在较新版本的docker中，可直接使用prune命令：

bash
docker volume prune

Q6. 为什么启动时出现（可能间歇性的）失败？
A7. 如果在/var/log/supervisor/supervisord.log中看到以下行：
unix:///var/run/supervisor/supervisor.sock refused connection
您可能受到Linux内核https://github.com/moby/moby/issues/***%E7%9A%84%E5%BD%B1%E5%93%8D%EF%BC%8C%E8%AF%A5bug%E5%8F%AF%E8%83%BD%E5%AF%BC%E8%87%B4overlayfs%E6%97%A0%E6%B3%95%E4%B8%8Eunix%E5%9F%9F%E5%A5%97%E6%8E%A5%E5%AD%97%E4%B8%80%E8%B5%B7%E5%B7%A5%E4%BD%9C%E3%80%82