Ambari-Blueprint介绍

Ambari-Blueprint总体介绍

• ambari-blueprint主要作用是通过提供一个restAPI。调用几次API就能够创建一个集群。ambari-server解析stack下的role_command_order.json文件来自己主动部署集群。role_command_order.json文件记录着各个服务与组件的部署顺序。ambari-server会自己主动依据顺序建立task，这样就简化了单步创建时调用restapi的多次调用。

Ambari-Blueprint使用步骤

• 使用POST方法建立blueprint           注意：在ambari 1.4之后 在调用restapi时须要增加 -H "X-Requested-By:ambari"

  •  格式化json网址：http://www.bejson.com/

     压缩json网址：http://www.bejson.com/go.html?

    u=http://www.bejson.com/zhuanyi.html

  • request body 例如以下：(集群组件仅仅含有部分 不全 包含HDFS的nn dn ZK的server)
    {
      "host_groups" : [
        {
          "name" : "master",
          "configurations" : [
          ],
          "components" : [
            {
              "name" : "NAMENODE"
            },
            {
              "name" : "ZOOKEEPER_SERVER"
            }

          ],
          "cardinality" : "1"
        },
        {
          "name" : "slaves",
          "components" : [
            {
              "name" : "DATANODE"
            },
            {
              "name" : "ZOOKEEPER_SERVER"
            }
          ],
          "cardinality" : "1+"
        }
      ],
      "Blueprints" : {
        "stack_name" : "HDP",
        "stack_version" : "2.0.6"
      }
    }

  • 调用命令例如以下所看到的 

    curl -u admin:admin -i -X POST -d '<request body>' -H "X-Requested-By:ambari" http://<ambari-server host>:8080/api/v1/blueprints/<buleprint-name>
    
    

• 分配host完毕集群建立

  • 使用http post请求完毕host分配

  •  

    {

      "blueprint" : "<blueprint-name>",

      "host_groups" :[

        {

          "name" : "master", 

          "hosts" : [         

            {

              "fqdn" : "<master-host>"

            }

          ]

        },

        {

          "name" : "slaves", 

          "hosts" : [

            {

              "fqdn" : "<slave-host>"

            },

            {

              "fqdn" : "<slave-host>"

            }

          ]

        }

      ]

    }

  • 详细命令例如以下

    curl -u admin:admin -i -X POST -d '{"blueprint":"<blueprint-name>","host_groups":[{"name":"master","hosts":[{"fqdn":"<master-host>"}]},{"name":"slaves","hosts":[{"fqdn":"<slave-host>"},{"fqdn":"<slave-host>"}]}]}' -H "X-Requested-By:ambari" http://<ambari-server host>:8080/api/v1/clusters/<cluster-name>

  • 这样就创建了集群名为<cluster-name>的集群了。调用后自己主动依照role_command_order.json中设置的顺序进行组件的安装、开启。创建成功后会返回例如以下状态：

    202 - Accepted
    {
        "href" : "http://c6401.ambari.apache.org:8080/api/v1/clusters/MyCluster/requests/1",
        "Requests" : {
        "id" : 1,
        "status" : "InProgress"
    }
    
    

  • 在浏览器中打开返回的链接，页面上显示的是每个安装、开启组件的任务的进度，假设没有出现失败的task。那么会staus更改为COMPLETED。证明集群创建成功。假设失败，能够通过task连接转到task页面查看失败信息。