ibmcom/cloudant-developer

!https://s3.amazonaws.com/media.cloudant.com/images/ibm_cloudant_blue.png

重要更新：已弃用

Cloudant开发者版已不再维护。建议使用最新的https://hub.docker.com/_/couchdb%E9%95%9C%E5%83%8F%E8%BF%9B%E8%A1%8CIBM Cloudant的本地开发。参见IBM Cloudant文档中的https://cloud.ibm.com/docs/services/Cloudant?topic=cloudant-apache-couchdb#couchdb-and-cloudant%E3%80%82

什么是Cloudant开发者版？

Cloudant开发者版有以下限制：

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

入门

下载并安装[***]

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

docker pull docker.xuanyuan.run/ibmcom/cloudant-developer

启动Cloudant开发者版容器

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

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

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

version: '3'
services:

  cloudant-developer:
    build:
      context: .
    image: docker.xuanyuan.run/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

最终用户许可

本镜像仅许可用于开发目的，不得用于生产环境。请http://www14.software.ibm.com/cgi-bin/weblap/lap.pl?li_formnum=L-ARAA-AAVJJA&popup=n&title=IBM%20Cloudant%20Developer%20Editionthe%E6%9C%80%E7%BB%88%E7%94%A8%E6%88%B7%E8%AE%B8%E5%8F%AF%E5%8D%8F%E8%AE%AE%E3%80%82

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

Cloudant仪表盘

要访问Cloudant仪表盘，在浏览器中输入以下URL：http://localhost:8080/dashboard.html%E3%80%82%E9%BB%98%E8%AE%A4%E7%99%BB%E5%BD%95%E5%87%AD%E6%8D%AE%E4%B8%BA%EF%BC%9A

• 用户名 = admin
• 密码 = pass

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

支持的Docker版本

本镜像官方支持Docker 1.11.0版本。 对旧版本（低至1.9）的支持基于尽力而为原则。 有关如何升级Docker守护程序的详细信息，请参见https://docs.docker.com/engine/installation/%E3%80%82

附加信息

有关使用Cloudant API的更多信息，请参见在线文档。对于技术问题，请在http://stackoverflow.com/search?q=cloudant%E4%B8%8A%E6%90%9C%E7%B4%A2Cloudant%E3%80%82%E5%A6%82%E6%9E%9C%E6%9C%AA%E6%89%BE%E5%88%B0%E7%AD%94%E6%A1%88%EF%BC%8C%E8%AF%B7%E4%BD%BF%E7%94%A8%E6%A0%87%E7%AD%BE%E2%80%9Ccloudant%E2%80%9D%E5%8F%91%E5%B8%83%E9%97%AE%E9%A2%98%E3%80%82

许可证

Dockerfile和相关脚本根据http://www.apache.org/licenses/LICENSE-2.0%E8%AE%B8%E5%8F%AF%E3%80%82Cloudant-developer%E6%A0%B9%E6%8D%AEIBM International License Agreement for Non-Warranted Programs许可。Cloudant开发者版的此许可可在http://www-03.ibm.com/software/sla/sladb.nsf/displaylis/5DF1EE***D3F***DAB0064BEFA?OpenDocument%E6%9F%A5%E7%9C%8B%E3%80%82%E8%AF%B7%E6%B3%A8%E6%84%8F%EF%BC%8C%E6%AD%A4%E8%AE%B8%E5%8F%AF%E4%B8%8D%E5%85%81%E8%AE%B8%E8%BF%9B%E4%B8%80%E6%AD%A5%E5%88%86%E5%8F%91%E3%80%82

从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