Deis控制器API v1.6详解

Deis控制器API v1.6详解

deis Deis v1, the CoreOS and Docker PaaS: Your PaaS. Your Rules. 项目地址: https://gitcode.com/gh_mirrors/de/deis

Deis是一个开源的PaaS平台，它简化了在私有云或公有云上部署和管理应用程序的过程。本文将深入解析Deis控制器API v1.6版本的功能和使用方法。

API v1.6新特性

在v1.6版本中，Deis控制器API引入了几个重要的改进：

1. 管理员权限优化：

   • 管理员现在可以无需提供密码就能修改其他用户的密码
   • 管理员可以无需提供密码就能删除其他用户

2. 分页功能增强：

   • 新增了?page_size查询参数，允许设置每页返回的结果数量

认证管理

用户注册

要注册新用户，可以发送以下请求：

POST /v1/auth/register/
{
    "username": "test",
    "password": "opensesame",
    "email": "test@example.com"
}

可选参数包括first_name和last_name。

用户登录

用户登录请求示例：

POST /v1/auth/login/
{
    "username": "test", 
    "password": "opensesame"
}

成功登录后会返回一个认证令牌(token)。

密码管理

修改密码的请求示例：

POST /v1/auth/passwd/
{
    "password": "foo",
    "new_password": "bar"
}

管理员可以指定username参数来修改其他用户的密码。

应用管理

创建应用

创建新应用的请求示例：

POST /v1/apps/
{
    "id": "example-go"
}

应用列表

获取所有应用的列表：

GET /v1/apps

应用详情

查看特定应用的详细信息：

GET /v1/apps/example-go/

应用日志

获取应用日志：

GET /v1/apps/example-go/logs/

可以通过?log_lines=参数指定要获取的日志行数。

证书管理

证书列表

获取所有证书：

GET /v1/certs

添加证书

添加新证书的请求示例：

POST /v1/certs/
{
    "certificate": "-----BEGIN CERTIFICATE-----",
    "key": "-----BEGIN RSA PRIVATE KEY-----",
    "common_name": "test.example.com"
}

容器管理

容器列表

获取应用的所有容器：

GET /v1/apps/example-go/containers/

容器重启

重启所有容器：

POST /v1/apps/example-go/containers/restart/

也可以按类型或编号重启特定容器。

容器扩缩容

调整容器数量：

POST /v1/apps/example-go/scale/
{
    "web": 3
}

配置管理

获取配置

获取应用的配置：

GET /v1/apps/example-go/config/

更新配置

更新配置变量：

POST /v1/apps/example-go/config/
{
    "values": {
        "HELLO": "world",
        "PLATFORM": "deis"
    }
}

删除配置

删除配置变量：

POST /v1/apps/example-go/config/
{
    "values": {
        "HELLO": null
    }
}

域名管理

添加域名

为应用添加域名：

POST /v1/apps/example-go/domains/
{
    "domain": "example.example.com"
}

删除域名

移除应用的域名：

DELETE /v1/apps/example-go/domains/example.example.com

构建管理

构建列表

获取应用的构建历史：

GET /v1/apps/example-go/builds/

通过掌握Deis控制器API v1.6的这些功能，开发者可以更高效地管理和部署应用，充分利用Deis平台提供的PaaS能力。

deis Deis v1, the CoreOS and Docker PaaS: Your PaaS. Your Rules. 项目地址: https://gitcode.com/gh_mirrors/de/deis