fluke/devops-service/app/api2/routes/server.rb

module Devops
  module API2_0
    module Routes
      module ServerRoutes

        def self.registered(app)

          # Get devops servers list
          #
          # * *Request*
          #   - method : GET
          #   - headers :
          #     - Accept: application/json
          #   - params :
          #     - fields - show server fields, available values: project, deploy_env, provider, remote_user, private_ip, public_ip, created_at, created_by, static, key, reserved_by
          #
          # * *Returns* :
          #   [
          #     {
          #       "id": "instance id",
          #       "chef_node_name": "chef name"
          #     }
          #   ]
          app.get_with_headers "/servers", :headers => [:accept] do
            check_privileges("server", "r")
            json Devops::API2_0::Handler::Server.new(request).servers
          end

          # Get chef nodes list
          #
          # * *Request*
          #   - method : GET
          #   - headers :
          #     - Accept: application/json
          #
          # * *Returns* :
          #   [
          #     {
          #       "chef_node_name": "chef name"
          #     }
          #   ]
          app.get_with_headers "/servers/chef", :headers => [:accept] do
            check_privileges("server", "r")
            json Devops::API2_0::Handler::Server.new(request).chef_servers
          end

          # Get provider servers list
          #
          # * *Request*
          #   - method : GET
          #   - headers :
          #     - Accept: application/json
          #
          # * *Returns* :
          #   -ec2
          #   [
          #      {
          #       "state": "running",
          #       "name": "name",
          #       "image": "ami-83e4bcea",
          #       "flavor": "m1.small",
          #       "keypair": "ssh key",
          #       "instance_id": "i-8441bfd4",
          #       "dns_name": "ec2-204-236-199-49.compute-1.amazonaws.com",
          #       "zone": "us-east-1d",
          #       "private_ip": "10.215.217.210",
          #       "public_ip": "204.236.199.49",
          #       "launched_at": "2014-04-25 07:56:33 UTC"
          #     }
          #   ]
          #   -openstack
          #   [
          #     {
          #       "state": "ACTIVE",
          #       "name": "name",
          #       "image": "image id",
          #       "flavor": null,
          #       "keypair": "ssh key",
          #       "instance_id": "instance id",
          #       "private_ip": "172.17.0.1"
          #     }
          #   ]
          app.get_with_headers "/servers/:provider", :headers => [:accept] do |provider|
            check_privileges("server", "r")
            json Devops::API2_0::Handler::Server.new(request).provider_servers(provider)
          end

          # Get server info by :name
          #
          # * *Request*
          #   - method : GET
          #   - headers :
          #     - Accept: application/json
          #   - parameters:
          #     key=instance -> search server by instance_id rather then chef_node_name
          #
          # * *Returns* :
          #   [
          #     {
          #       "chef_node_name": "chef name"
          #     }
          #   ]
          hash = {}
          hash["GET"] = lambda {|id|
            check_privileges("server", "r")
            json Devops::API2_0::Handler::Server.new(request).server(id).to_hash
          }

          # Delete devops server
          #
          # * *Request*
          #   - method : DELETE
          #   - headers :
          #     - Accept: application/json
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "key": "instance", -> search server by instance_id rather then chef_node_name
          #     }
          #
          # * *Returns* :
          #   200 - Deleted
          hash["DELETE"] = lambda {|id|
            check_privileges("server", "w")
            info, r = Devops::API2_0::Handler::Server.new(request).delete(id)
            create_response(info, r)
          }
          app.multi_routes "/server/:id", {:headers => [:accept, :content_type]}, hash

          # Create devops server
          #
          # * *Request*
          #   - method : POST
          #   - headers :
          #     - X-Stream: true -> return output in text stream
          #     - Accept: application/json
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "project": "project name", -> mandatory parameter
          #       "deploy_env": "env",       -> mandatory parameter
          #       "name": "server_name",     -> if null, name will be generated
          #       "without_bootstrap": null, -> do not install chef on instance if true
          #       "force": null,             -> do not delete server on error
          #       "groups": [],              -> specify special security groups, overrides value from project env
          #       "key": "ssh key"           -> specify ssh key for server, overrides value from project env
          #     }
          #
          # * *Returns* : text stream
          app.post_with_headers "/server", :headers => [:accept, :content_type] do
            check_privileges("server", "w")
            handler = Devops::API2_0::Handler::Server.new(request)
            if request["X-Stream"]
              stream() do |out|
                begin
                  status = handler.create_server_stream out
                  out << create_status(status)
                rescue IOError => e
                  logger.error e.message
                end
              end
            else
              json handler.create_server
            end
          end

          # Pause devops server by name
          #
          # * *Request*
          #   - method : POST
          #   - headers :
          #     - Accept: application/json
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "key": "instance", -> search server by instance_id rather then chef_node_name
          #     }
          #
          # * *Returns* :
          #   200 - Paused
          app.post_with_headers "/server/:node_name/pause", :headers => [:accept, :content_type] do |node_name|
            check_privileges("server", "w")
            info = Devops::API2_0::Handler::Server.new(request).pause_server(node_name)
            create_response(info)
          end

          # Unpause devops server by name
          #
          # * *Request*
          #   - method : POST
          #   - headers :
          #     - Accept: application/json
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "key": "instance", -> search server by instance_id rather then chef_node_name
          #     }
          #
          # * *Returns* :
          #   200 - Unpaused
          app.post_with_headers "/server/:node_name/unpause", :headers => [:accept, :content_type] do |node_name|
            check_privileges("server", "w")
            info = Devops::API2_0::Handler::Server.new(request).unpause_server(node_name)
            create_response(info)
          end

          # Reserve devops server
          #
          # * *Request*
          #   - method : POST
          #   - headers :
          #     - Accept: application/json
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "key": "instance", -> search server by instance_id rather then chef_node_name
          #     }
          #
          # * *Returns* :
          #   200 - Reserved
          app.post_with_headers "/server/:node_name/reserve", :headers => [:accept, :content_type] do |node_name|
            check_privileges("server", "w")
            Devops::API2_0::Handler::Server.new(request).reserve_server(node_name)
            create_response("Server '#{node_name}' has been reserved")
          end

          # Unreserve devops server
          #
          # * *Request*
          #   - method : POST
          #   - headers :
          #     - Accept: application/json
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "key": "instance", -> search server by instance_id rather then chef_node_name
          #     }
          #
          # * *Returns* :
          #   200 - Unreserved
          app.post_with_headers "/server/:node_name/unreserve", :headers => [:accept, :content_type] do |node_name|
            check_privileges("server", "w")
            Devops::API2_0::Handler::Server.new(request).unreserve_server(node_name)
            create_response("Server '#{node_name}' has been unreserved")
          end

          # Bootstrap devops server
          #
          # * *Request*
          #   - method : POST
          #   - headers :
          #     - X-Stream: true -> return output in text stream
          #     - Accept: application/json
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "instance_id": "instance id", -> mandatory parameter
          #       "name": "server_name", -> if null, name will be generated
          #       "run_list": [], -> specify list of roles and recipes
          #       "bootstrap_template": "template" -> specify ssh key for server, overrides value from project env
          #     }
          #
          # * *Returns* : text stream
          app.post_with_headers "/server/bootstrap", :headers => [:accept, :content_type] do
            check_privileges("server", "w")

            handler = Devops::API2_0::Handler::Server.new(request)
            if request["X-Stream"]
              stream() do |out|
                begin
                  status = handler.bootstrap_server_stream out
                  out << create_status(status)
                rescue IOError => e
                  logger.error e.message
                end
              end
            else
              json handler.bootstrap_server()
            end
          end

          # Add external server to devops
          #
          # * *Request*
          #   - method : POST
          #   - headers :
          #     - Accept: application/json
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "project": "project name", -> mandatory parameter
          #       "deploy_env": "env",       -> mandatory parameter
          #       "key": "ssh key",          -> mandatory parameter
          #       "remote_user": "ssh user", -> mandatory parameter
          #       "private_ip": "ip",         -> mandatory parameter
          #       "public_ip": "ip"
          #     }
          #
          # * *Returns* :
          #   200 - Added
          app.post_with_headers "/server/add", :headers => [:accept, :content_type] do
            check_privileges("server", "w")
            info = Devops::API2_0::Handler::Server.new(request).add_server()
            create_response(info)
          end

          hash = {}
          # Add devops server tags
          #
          # * *Request*
          #   - method : PUT
          #   - headers :
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "tags": {"tag name": "tag value"}
          #       "key": "instance", -> search server by instance_id rather then chef_node_name
          #     }
          #
          # * *Returns* :
          #   200 - Added
          hash["PUT"] = lambda {|id|
            check_privileges("server", "w")
            Devops::API2_0::Handler::Server.new(request).set_tags(id)
            create_response("Added")
          }

          # Delete devops server tags
          #
          # * *Request*
          #   - method : DELETE
          #   - headers :
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "tags": {"tag name": "tag value"}
          #       "key": "instance", -> search server by instance_id rather then chef_node_name
          #     }
          #
          # * *Returns* :
          #   200 - Deleted
          hash["DELETE"] = lambda {|id|
            check_privileges("server", "w")
            Devops::API2_0::Handler::Server.new(request).unset_tags(id)
            create_response("Deleted")
          }
          app.multi_routes "/server/:id/tags", {:headers => [:content_type]}, hash

          # Set run_list to server
          #
          # * *Request*
          #   - method : PATCH
          #   - headers :
          #     - Accept: application/json
          #     - Content-Type: application/json
          #   - body :
          #     {
          #       "run_list": [
          #         "role[role_1]",
          #         "recipe[recipe_1]"
          #       ],
          #       "key": "instance", -> search server by instance_id rather then chef_node_name
          #     }
          #
          # * *Returns* :
          #   200 - Updated
          app.patch_with_headers "/server/:id/run_list", :headers => [:accept, :content_type] do |node_name|
            check_privileges("server", "w")
            Devops::API2_0::Handler::Server.new(request).set_server_run_list(node_name)
            create_response("Run list has been changed")
          end

          puts "Server routes initialized"
        end

      end
    end
  end
end