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页面查看失败信息。