py-serverless-kit 2.3.4__py3-none-any.whl → 2.3.6__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,2 +1,2 @@
1
- __version__ = "2.3.4"
1
+ __version__ = "2.3.6"
2
2
  __author__ = "Asif Khan @ Kavion.ai"
@@ -136,9 +136,10 @@ Operate
136
136
  logs Tail deployed logs pskit logs -f --function worker
137
137
  trigger Send a real test event pskit trigger -f worker -e 0 -d '{"id": 1}'
138
138
  dashboard Deployment dashboard pskit dashboard --serve --open
139
- cluster create | join | leave | status | check | watch | alerts | requests | scale | balancer | list | remove
139
+ cluster create | join | leave | set | status | check | watch | alerts | requests | scale | balancer | list | remove
140
140
  pskit cluster create prod --orchestrator swarm --master edge1
141
141
  pskit cluster join prod edge2
142
+ pskit cluster set prod --master-serves
142
143
  pskit cluster balancer set prod lb1
143
144
  pskit cluster leave prod edge2 --yes
144
145
  pskit cluster status prod
@@ -1401,6 +1402,7 @@ def cluster() -> None:
1401
1402
  Examples:
1402
1403
  pskit cluster create prod --orchestrator swarm --master edge1
1403
1404
  pskit cluster join prod edge2 # also while functions are running
1405
+ pskit cluster set prod --no-master-serves # master only as a backup; joined servers take the requests
1404
1406
  pskit cluster status prod # CPU / memory / disk of every server, replicas, full?
1405
1407
  pskit cluster alerts prod --function notify-devops --webhook https://hooks.slack.com/...
1406
1408
  pskit cluster watch prod # check every minute, alert when every server is full
@@ -1469,7 +1471,8 @@ def cluster_list(as_json: bool, config_path: Optional[str]) -> None:
1469
1471
  info("No clusters. Create one: pskit cluster create NAME --orchestrator swarm --master SERVER")
1470
1472
  return
1471
1473
  for item in items:
1472
- servers = ", ".join(f"{n['server']}{' (master)' if n.get('role') == 'master' else ''}" for n in item["nodes"])
1474
+ master = " (master)" if item.get("master_serves") else " (master, backup only)"
1475
+ servers = ", ".join(f"{n['server']}{master if n.get('role') == 'master' else ''}" for n in item["nodes"])
1473
1476
  echo(f" {item['name']:<14} {item['orchestrator_label']:<18} {servers}")
1474
1477
  balancer = item.get("balancer") or {}
1475
1478
  if balancer:
@@ -1485,17 +1488,36 @@ def cluster_list(as_json: bool, config_path: Optional[str]) -> None:
1485
1488
  @click.option("--master", required=True, help="Saved server that runs the control plane and the main replica.")
1486
1489
  @click.option("--advertise", default="", help="The master's address other servers use (default: its host).")
1487
1490
  @click.option("--nomad-version", default="", help="Nomad release to install (default: the tested one).")
1491
+ @click.option("--master-serves/--no-master-serves", "master_serves", default=None,
1492
+ help="Send requests to the master too, next to the joined servers. Off: the master is only a backup, "
1493
+ "used while every other server is down. Default: off on Nomad, on on Swarm and k3s.")
1488
1494
  @_CONFIG_OPTION
1489
1495
  def cluster_create(name: str, orchestrator: str, master: str, advertise: str, nomad_version: str,
1490
- config_path: Optional[str]) -> None:
1496
+ master_serves: Optional[bool], config_path: Optional[str]) -> None:
1491
1497
  """Install the orchestrator on MASTER and save cluster NAME."""
1492
1498
  from ..core.onprem_cluster import create_cluster
1493
1499
 
1494
1500
  _cluster_call(create_cluster, _cluster_root(config_path), name, orchestrator, master, echo, advertise=advertise,
1495
- nomad_version=nomad_version)
1501
+ nomad_version=nomad_version, serve_on_master=master_serves)
1496
1502
  ok(f"Cluster {name} created. In pskit.yml: provider.options.cluster: {name}")
1497
1503
 
1498
1504
 
1505
+ @cluster.command("set")
1506
+ @click.argument("name")
1507
+ @click.option("--master-serves/--no-master-serves", "master_serves", default=None,
1508
+ help="Send requests to the master too (on), or use it only while every other server is down (off).")
1509
+ @_CONFIG_OPTION
1510
+ def cluster_set(name: str, master_serves: Optional[bool], config_path: Optional[str]) -> None:
1511
+ """Change how cluster NAME spreads requests. The load balancers follow at once; Swarm and k3s move web
1512
+ replicas on or off the master at the next pskit deploy."""
1513
+ from ..core.onprem_cluster import set_master_serves
1514
+
1515
+ if master_serves is None:
1516
+ raise click.UsageError("nothing to change: pass --master-serves or --no-master-serves")
1517
+ _cluster_call(set_master_serves, _cluster_root(config_path), name, master_serves, echo)
1518
+ ok(f"{name}: the master {'serves requests' if master_serves else 'is only a backup'}")
1519
+
1520
+
1499
1521
  @cluster.command("join")
1500
1522
  @click.argument("name")
1501
1523
  @click.argument("server")