cluster_routes.go 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525
  1. package swarm // import "github.com/docker/docker/api/server/router/swarm"
  2. import (
  3. "context"
  4. "fmt"
  5. "net/http"
  6. "strconv"
  7. "github.com/docker/docker/api/server/httputils"
  8. basictypes "github.com/docker/docker/api/types"
  9. "github.com/docker/docker/api/types/backend"
  10. "github.com/docker/docker/api/types/filters"
  11. types "github.com/docker/docker/api/types/swarm"
  12. "github.com/docker/docker/api/types/versions"
  13. "github.com/docker/docker/errdefs"
  14. "github.com/pkg/errors"
  15. "github.com/sirupsen/logrus"
  16. )
  17. func (sr *swarmRouter) initCluster(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  18. var req types.InitRequest
  19. if err := httputils.ReadJSON(r, &req); err != nil {
  20. return err
  21. }
  22. version := httputils.VersionFromContext(ctx)
  23. // DefaultAddrPool and SubnetSize were added in API 1.39. Ignore on older API versions.
  24. if versions.LessThan(version, "1.39") {
  25. req.DefaultAddrPool = nil
  26. req.SubnetSize = 0
  27. }
  28. // DataPathPort was added in API 1.40. Ignore this option on older API versions.
  29. if versions.LessThan(version, "1.40") {
  30. req.DataPathPort = 0
  31. }
  32. nodeID, err := sr.backend.Init(req)
  33. if err != nil {
  34. logrus.Errorf("Error initializing swarm: %v", err)
  35. return err
  36. }
  37. return httputils.WriteJSON(w, http.StatusOK, nodeID)
  38. }
  39. func (sr *swarmRouter) joinCluster(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  40. var req types.JoinRequest
  41. if err := httputils.ReadJSON(r, &req); err != nil {
  42. return err
  43. }
  44. return sr.backend.Join(req)
  45. }
  46. func (sr *swarmRouter) leaveCluster(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  47. if err := httputils.ParseForm(r); err != nil {
  48. return err
  49. }
  50. force := httputils.BoolValue(r, "force")
  51. return sr.backend.Leave(force)
  52. }
  53. func (sr *swarmRouter) inspectCluster(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  54. swarm, err := sr.backend.Inspect()
  55. if err != nil {
  56. logrus.Errorf("Error getting swarm: %v", err)
  57. return err
  58. }
  59. return httputils.WriteJSON(w, http.StatusOK, swarm)
  60. }
  61. func (sr *swarmRouter) updateCluster(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  62. var swarm types.Spec
  63. if err := httputils.ReadJSON(r, &swarm); err != nil {
  64. return err
  65. }
  66. rawVersion := r.URL.Query().Get("version")
  67. version, err := strconv.ParseUint(rawVersion, 10, 64)
  68. if err != nil {
  69. err := fmt.Errorf("invalid swarm version '%s': %v", rawVersion, err)
  70. return errdefs.InvalidParameter(err)
  71. }
  72. var flags types.UpdateFlags
  73. if value := r.URL.Query().Get("rotateWorkerToken"); value != "" {
  74. rot, err := strconv.ParseBool(value)
  75. if err != nil {
  76. err := fmt.Errorf("invalid value for rotateWorkerToken: %s", value)
  77. return errdefs.InvalidParameter(err)
  78. }
  79. flags.RotateWorkerToken = rot
  80. }
  81. if value := r.URL.Query().Get("rotateManagerToken"); value != "" {
  82. rot, err := strconv.ParseBool(value)
  83. if err != nil {
  84. err := fmt.Errorf("invalid value for rotateManagerToken: %s", value)
  85. return errdefs.InvalidParameter(err)
  86. }
  87. flags.RotateManagerToken = rot
  88. }
  89. if value := r.URL.Query().Get("rotateManagerUnlockKey"); value != "" {
  90. rot, err := strconv.ParseBool(value)
  91. if err != nil {
  92. return errdefs.InvalidParameter(fmt.Errorf("invalid value for rotateManagerUnlockKey: %s", value))
  93. }
  94. flags.RotateManagerUnlockKey = rot
  95. }
  96. if err := sr.backend.Update(version, swarm, flags); err != nil {
  97. logrus.Errorf("Error configuring swarm: %v", err)
  98. return err
  99. }
  100. return nil
  101. }
  102. func (sr *swarmRouter) unlockCluster(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  103. var req types.UnlockRequest
  104. if err := httputils.ReadJSON(r, &req); err != nil {
  105. return err
  106. }
  107. if err := sr.backend.UnlockSwarm(req); err != nil {
  108. logrus.Errorf("Error unlocking swarm: %v", err)
  109. return err
  110. }
  111. return nil
  112. }
  113. func (sr *swarmRouter) getUnlockKey(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  114. unlockKey, err := sr.backend.GetUnlockKey()
  115. if err != nil {
  116. logrus.WithError(err).Errorf("Error retrieving swarm unlock key")
  117. return err
  118. }
  119. return httputils.WriteJSON(w, http.StatusOK, &basictypes.SwarmUnlockKeyResponse{
  120. UnlockKey: unlockKey,
  121. })
  122. }
  123. func (sr *swarmRouter) getServices(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  124. if err := httputils.ParseForm(r); err != nil {
  125. return err
  126. }
  127. filter, err := filters.FromJSON(r.Form.Get("filters"))
  128. if err != nil {
  129. return err
  130. }
  131. // the status query parameter is only support in API versions >= 1.41. If
  132. // the client is using a lesser version, ignore the parameter.
  133. cliVersion := httputils.VersionFromContext(ctx)
  134. var status bool
  135. if value := r.URL.Query().Get("status"); value != "" && !versions.LessThan(cliVersion, "1.41") {
  136. var err error
  137. status, err = strconv.ParseBool(value)
  138. if err != nil {
  139. return errors.Wrapf(errdefs.InvalidParameter(err), "invalid value for status: %s", value)
  140. }
  141. }
  142. services, err := sr.backend.GetServices(basictypes.ServiceListOptions{Filters: filter, Status: status})
  143. if err != nil {
  144. logrus.Errorf("Error getting services: %v", err)
  145. return err
  146. }
  147. return httputils.WriteJSON(w, http.StatusOK, services)
  148. }
  149. func (sr *swarmRouter) getService(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  150. var insertDefaults bool
  151. if value := r.URL.Query().Get("insertDefaults"); value != "" {
  152. var err error
  153. insertDefaults, err = strconv.ParseBool(value)
  154. if err != nil {
  155. return errors.Wrapf(errdefs.InvalidParameter(err), "invalid value for insertDefaults: %s", value)
  156. }
  157. }
  158. // you may note that there is no code here to handle the "status" query
  159. // parameter, as in getServices. the Status field is not supported when
  160. // retrieving an individual service because the Backend API changes
  161. // required to accommodate it would be too disruptive, and because that
  162. // field is so rarely needed as part of an individual service inspection.
  163. service, err := sr.backend.GetService(vars["id"], insertDefaults)
  164. if err != nil {
  165. logrus.Errorf("Error getting service %s: %v", vars["id"], err)
  166. return err
  167. }
  168. return httputils.WriteJSON(w, http.StatusOK, service)
  169. }
  170. func (sr *swarmRouter) createService(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  171. var service types.ServiceSpec
  172. if err := httputils.ReadJSON(r, &service); err != nil {
  173. return err
  174. }
  175. // Get returns "" if the header does not exist
  176. encodedAuth := r.Header.Get("X-Registry-Auth")
  177. queryRegistry := false
  178. if v := httputils.VersionFromContext(ctx); v != "" {
  179. if versions.LessThan(v, "1.30") {
  180. queryRegistry = true
  181. }
  182. adjustForAPIVersion(v, &service)
  183. }
  184. resp, err := sr.backend.CreateService(service, encodedAuth, queryRegistry)
  185. if err != nil {
  186. logrus.Errorf("Error creating service %s: %v", service.Name, err)
  187. return err
  188. }
  189. return httputils.WriteJSON(w, http.StatusCreated, resp)
  190. }
  191. func (sr *swarmRouter) updateService(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  192. var service types.ServiceSpec
  193. if err := httputils.ReadJSON(r, &service); err != nil {
  194. return err
  195. }
  196. rawVersion := r.URL.Query().Get("version")
  197. version, err := strconv.ParseUint(rawVersion, 10, 64)
  198. if err != nil {
  199. err := fmt.Errorf("invalid service version '%s': %v", rawVersion, err)
  200. return errdefs.InvalidParameter(err)
  201. }
  202. var flags basictypes.ServiceUpdateOptions
  203. // Get returns "" if the header does not exist
  204. flags.EncodedRegistryAuth = r.Header.Get("X-Registry-Auth")
  205. flags.RegistryAuthFrom = r.URL.Query().Get("registryAuthFrom")
  206. flags.Rollback = r.URL.Query().Get("rollback")
  207. queryRegistry := false
  208. if v := httputils.VersionFromContext(ctx); v != "" {
  209. if versions.LessThan(v, "1.30") {
  210. queryRegistry = true
  211. }
  212. adjustForAPIVersion(v, &service)
  213. }
  214. resp, err := sr.backend.UpdateService(vars["id"], version, service, flags, queryRegistry)
  215. if err != nil {
  216. logrus.Errorf("Error updating service %s: %v", vars["id"], err)
  217. return err
  218. }
  219. return httputils.WriteJSON(w, http.StatusOK, resp)
  220. }
  221. func (sr *swarmRouter) removeService(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  222. if err := sr.backend.RemoveService(vars["id"]); err != nil {
  223. logrus.Errorf("Error removing service %s: %v", vars["id"], err)
  224. return err
  225. }
  226. return nil
  227. }
  228. func (sr *swarmRouter) getTaskLogs(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  229. if err := httputils.ParseForm(r); err != nil {
  230. return err
  231. }
  232. // make a selector to pass to the helper function
  233. selector := &backend.LogSelector{
  234. Tasks: []string{vars["id"]},
  235. }
  236. return sr.swarmLogs(ctx, w, r, selector)
  237. }
  238. func (sr *swarmRouter) getServiceLogs(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  239. if err := httputils.ParseForm(r); err != nil {
  240. return err
  241. }
  242. // make a selector to pass to the helper function
  243. selector := &backend.LogSelector{
  244. Services: []string{vars["id"]},
  245. }
  246. return sr.swarmLogs(ctx, w, r, selector)
  247. }
  248. func (sr *swarmRouter) getNodes(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  249. if err := httputils.ParseForm(r); err != nil {
  250. return err
  251. }
  252. filter, err := filters.FromJSON(r.Form.Get("filters"))
  253. if err != nil {
  254. return err
  255. }
  256. nodes, err := sr.backend.GetNodes(basictypes.NodeListOptions{Filters: filter})
  257. if err != nil {
  258. logrus.Errorf("Error getting nodes: %v", err)
  259. return err
  260. }
  261. return httputils.WriteJSON(w, http.StatusOK, nodes)
  262. }
  263. func (sr *swarmRouter) getNode(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  264. node, err := sr.backend.GetNode(vars["id"])
  265. if err != nil {
  266. logrus.Errorf("Error getting node %s: %v", vars["id"], err)
  267. return err
  268. }
  269. return httputils.WriteJSON(w, http.StatusOK, node)
  270. }
  271. func (sr *swarmRouter) updateNode(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  272. var node types.NodeSpec
  273. if err := httputils.ReadJSON(r, &node); err != nil {
  274. return err
  275. }
  276. rawVersion := r.URL.Query().Get("version")
  277. version, err := strconv.ParseUint(rawVersion, 10, 64)
  278. if err != nil {
  279. err := fmt.Errorf("invalid node version '%s': %v", rawVersion, err)
  280. return errdefs.InvalidParameter(err)
  281. }
  282. if err := sr.backend.UpdateNode(vars["id"], version, node); err != nil {
  283. logrus.Errorf("Error updating node %s: %v", vars["id"], err)
  284. return err
  285. }
  286. return nil
  287. }
  288. func (sr *swarmRouter) removeNode(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  289. if err := httputils.ParseForm(r); err != nil {
  290. return err
  291. }
  292. force := httputils.BoolValue(r, "force")
  293. if err := sr.backend.RemoveNode(vars["id"], force); err != nil {
  294. logrus.Errorf("Error removing node %s: %v", vars["id"], err)
  295. return err
  296. }
  297. return nil
  298. }
  299. func (sr *swarmRouter) getTasks(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  300. if err := httputils.ParseForm(r); err != nil {
  301. return err
  302. }
  303. filter, err := filters.FromJSON(r.Form.Get("filters"))
  304. if err != nil {
  305. return err
  306. }
  307. tasks, err := sr.backend.GetTasks(basictypes.TaskListOptions{Filters: filter})
  308. if err != nil {
  309. logrus.Errorf("Error getting tasks: %v", err)
  310. return err
  311. }
  312. return httputils.WriteJSON(w, http.StatusOK, tasks)
  313. }
  314. func (sr *swarmRouter) getTask(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  315. task, err := sr.backend.GetTask(vars["id"])
  316. if err != nil {
  317. logrus.Errorf("Error getting task %s: %v", vars["id"], err)
  318. return err
  319. }
  320. return httputils.WriteJSON(w, http.StatusOK, task)
  321. }
  322. func (sr *swarmRouter) getSecrets(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  323. if err := httputils.ParseForm(r); err != nil {
  324. return err
  325. }
  326. filters, err := filters.FromJSON(r.Form.Get("filters"))
  327. if err != nil {
  328. return err
  329. }
  330. secrets, err := sr.backend.GetSecrets(basictypes.SecretListOptions{Filters: filters})
  331. if err != nil {
  332. return err
  333. }
  334. return httputils.WriteJSON(w, http.StatusOK, secrets)
  335. }
  336. func (sr *swarmRouter) createSecret(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  337. var secret types.SecretSpec
  338. if err := httputils.ReadJSON(r, &secret); err != nil {
  339. return err
  340. }
  341. version := httputils.VersionFromContext(ctx)
  342. if secret.Templating != nil && versions.LessThan(version, "1.37") {
  343. return errdefs.InvalidParameter(errors.Errorf("secret templating is not supported on the specified API version: %s", version))
  344. }
  345. id, err := sr.backend.CreateSecret(secret)
  346. if err != nil {
  347. return err
  348. }
  349. return httputils.WriteJSON(w, http.StatusCreated, &basictypes.SecretCreateResponse{
  350. ID: id,
  351. })
  352. }
  353. func (sr *swarmRouter) removeSecret(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  354. if err := sr.backend.RemoveSecret(vars["id"]); err != nil {
  355. return err
  356. }
  357. w.WriteHeader(http.StatusNoContent)
  358. return nil
  359. }
  360. func (sr *swarmRouter) getSecret(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  361. secret, err := sr.backend.GetSecret(vars["id"])
  362. if err != nil {
  363. return err
  364. }
  365. return httputils.WriteJSON(w, http.StatusOK, secret)
  366. }
  367. func (sr *swarmRouter) updateSecret(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  368. var secret types.SecretSpec
  369. if err := httputils.ReadJSON(r, &secret); err != nil {
  370. return err
  371. }
  372. rawVersion := r.URL.Query().Get("version")
  373. version, err := strconv.ParseUint(rawVersion, 10, 64)
  374. if err != nil {
  375. return errdefs.InvalidParameter(fmt.Errorf("invalid secret version"))
  376. }
  377. id := vars["id"]
  378. return sr.backend.UpdateSecret(id, version, secret)
  379. }
  380. func (sr *swarmRouter) getConfigs(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  381. if err := httputils.ParseForm(r); err != nil {
  382. return err
  383. }
  384. filters, err := filters.FromJSON(r.Form.Get("filters"))
  385. if err != nil {
  386. return err
  387. }
  388. configs, err := sr.backend.GetConfigs(basictypes.ConfigListOptions{Filters: filters})
  389. if err != nil {
  390. return err
  391. }
  392. return httputils.WriteJSON(w, http.StatusOK, configs)
  393. }
  394. func (sr *swarmRouter) createConfig(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  395. var config types.ConfigSpec
  396. if err := httputils.ReadJSON(r, &config); err != nil {
  397. return err
  398. }
  399. version := httputils.VersionFromContext(ctx)
  400. if config.Templating != nil && versions.LessThan(version, "1.37") {
  401. return errdefs.InvalidParameter(errors.Errorf("config templating is not supported on the specified API version: %s", version))
  402. }
  403. id, err := sr.backend.CreateConfig(config)
  404. if err != nil {
  405. return err
  406. }
  407. return httputils.WriteJSON(w, http.StatusCreated, &basictypes.ConfigCreateResponse{
  408. ID: id,
  409. })
  410. }
  411. func (sr *swarmRouter) removeConfig(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  412. if err := sr.backend.RemoveConfig(vars["id"]); err != nil {
  413. return err
  414. }
  415. w.WriteHeader(http.StatusNoContent)
  416. return nil
  417. }
  418. func (sr *swarmRouter) getConfig(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  419. config, err := sr.backend.GetConfig(vars["id"])
  420. if err != nil {
  421. return err
  422. }
  423. return httputils.WriteJSON(w, http.StatusOK, config)
  424. }
  425. func (sr *swarmRouter) updateConfig(ctx context.Context, w http.ResponseWriter, r *http.Request, vars map[string]string) error {
  426. var config types.ConfigSpec
  427. if err := httputils.ReadJSON(r, &config); err != nil {
  428. return err
  429. }
  430. rawVersion := r.URL.Query().Get("version")
  431. version, err := strconv.ParseUint(rawVersion, 10, 64)
  432. if err != nil {
  433. return errdefs.InvalidParameter(fmt.Errorf("invalid config version"))
  434. }
  435. id := vars["id"]
  436. return sr.backend.UpdateConfig(id, version, config)
  437. }