首页 > 代码库 > Ambari-Blueprint介绍

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

Ambari-Blueprint介绍