开发者

    应用仓库目前支持创建基于 QingStor 和 基于 S3 协议如 AWS 的对象存储，以及基于 HTTP/S 协议的仓库 (只读，详情见下文)，对象存储用来存放配置包和索引文件。以创建基于 QingStor 对象存储的仓库为例，若创建基于 AWS S3 对象存储及仓库管理参见 。

    首先登录 QingCloud 控制台，目前 QingCloud 支持在北京 3 区-A、北京 3 区、上海 1 区-A 使用对象存储，可以通过左上角切换可用区，比如切换到上海 1 区-A。

    第二步：创建 Bucket

    1、左侧导航栏依次选择 -> 对象存储 进入 。

    2、点击 创建 Bucket 按钮创建一个全局唯一的名称。

    对象存储bucket

    3、输入名称后点击 提交，这样就完成了 Bucket 的创建，其中的 Url ( API 访问用 ) 即为注册 OpenPitrix 仓库时所需要的 URL 参数。

    1、名称处右键弹出的菜单中选择 。

    配置bucket

    2、选择 访问控制，点击 添加用户 按钮。

    设置访问权限

    4、至此就完成了 QingStor 对象存储的相关配置，下一步可在 OpenPitrix 控制台添加对象存储作为仓库进行应用开发。

    第四步：创建仓库

    1、以开发者的身份登录 OpenPitrix 控制台，在菜单栏选择 仓库，然后点击 创建仓库。

    2、填写配置信息。创建完成后，对象存储中存储的应用配置包会被自动索引成为可部署的应用，关于各项配置的更多解释参见 创建仓库。

    • 运行环境服务商：可以多选，此处勾选 QingCloud 和 AWS (后续会提供更多的服务商支持)。其中 Kubernetes 与 QingCloud 和 AWS 环境的应用配置包格式不同，若选择 QingCloud 和 AWS，意味着当前仓库仅支持上传基于 的应用，既可以部署到 QingCloud，也可以部署到 AWS。若选择 Kubernetes 则表示当前仓库仅支持上传基于 Helm Chart 应用开发规范 的应用配置包，且只能部署到 Kubernetes 环境。

    • URL：若需要在 OpenPitrix 上传应用到仓库，则该仓库需要基于 S3 协议的对象存储。由于 QingStor 兼容 S3 协议，只需请求地址满足 S3 风格 即可使用 AWS S3 接口访问 QingStor 服务。因此选择 S3 协议，然后填写 s3://s3.sh1a.qingstor.com/my-openpitrix，这只是一个示例仓库，URL 填写实际的对象存储地址。Access Key ID 和 Secret Access Key 请参考 ，填写后点击 Validate 按钮可以检查配置是否有效。以下分别说明每种协议的场景：

      • S3：参数形式为 s3://s3.<region>.qingstor.com/<bucket_name>。可读可写，支持获取该应用仓库中的应用并能够部署到运行环境，这类协议的仓库支持在 OpenPitrix 中上传应用。
      • HTTP/HTTPS：可读，不可写，仅支持获取该应用仓库中的应用并能够部署到运行环境，但不支持在 OpenPitrix 上传应用到这类仓库。

    为方便您快速熟悉 OpenPitrix，本示例准备了一个基于 OpenPitrix 开发规范 的 的应用配置包，且已准备好 Wordpress 与 MySQL 镜像并上传到了 Docker 镜像仓库，点击 下载 Wordpress 应用配置包，选择 VM Package 文件夹下的 Wordpress-0.1.0.tgz 配置包。

    同样，也可参考 的三个必须的配置文件，然后获取 OpenPitrix 客户端工具 将配置文件打包 (默认为 格式)，即可生成一个 Wordpress 应用配置包。注意，基于 OpenPitrix 开发规范准备的应用可以部署到 QingCloud、AWS 这类云运行时环境 (Runtime)，若要部署到 Kubernetes 运行环境则需要基于 来准备应用配置包，或下载 Helm Chart Package 文件夹下的 wordpress-0.3.0.tar。参见 。

    第二步：上传应用

    1、开发者登录 OpenPitrix 控制台，选择左边菜单栏 我的应用，然后点击 “+” 或点击 创建。

    创建应用

    3、从本地上传应用配置包，注意，配置文件中应用的名字（package.json 的 name 字段值）不能与应用仓库中已有应用的名字重复，否则将无法上传。

    4、若配置包符合开发规范，则提示上传成功。配置包上传成功后，开发者和管理员可部署和测试应用，或在 我的应用 中查看。如果测试自己的应用需要先创建运行环境，请参考 普通用户 创建运行环境 章节。

    上传成功

    此时在 我的应用 下应用列表中可以看到上传的应用，状态显示为 待提交。若当前版本测试已通过，可以将此应用版本提交管理员审核，参见快速入门之 。但需要注意的是，提交审核之前请完善必要的应用信息，比如可在应用描述中详细介绍应用的功能以及特性，若用户想进一步了解应用时，描述内容的完整将变得尤为重要。应用提交后，状态则变为 “已提交”。

    若开发者提交应用版本后想撤回提交，可以点击 取消，状态将从 ”已提交“ 变为 ”待提交“。

    Wordpress 已提交

    1、当管理员审核通过后，应用版本的状态将变为 “已通过”，开发者可以根据自己的计划来选择时间上架此应用。应用一旦上架则意味着应用会出现在 商店 的应用列表中，用户可以随时浏览并部署应用，后续将引入财务管理支持用户购买应用。注意，上架的应用版本不允许再做任何修改，如有问题需要修复或服务需要升级请按上面的步骤提交新版本，等待审核通过后可以上架新版本，还可联系管理员将旧版本下架或删除。

    2、发布应用后，应用状态变为 “已上架”。在 我的应用 和 商店 都可以看到上架应用的详细信息。

    应用详情页