py-serverless-kit 0.3.0__tar.gz → 0.4.0__tar.gz

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.
Files changed (244) hide show
  1. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/CHANGELOG.md +7 -0
  2. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/PKG-INFO +2 -2
  3. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/README.md +1 -1
  4. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/architecture.md +1 -1
  5. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/configuration.md +1 -1
  6. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/getting-started.md +1 -1
  7. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/providers.md +19 -5
  8. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/troubleshooting.md +1 -1
  9. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/17-on-premises-remote/README.md +19 -7
  10. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/17-on-premises-remote/pskit.yml +4 -3
  11. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/_version.py +1 -1
  12. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/cli/main.py +37 -0
  13. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/cli/templates.py +1 -0
  14. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/onprem.py +27 -3
  15. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/onprem_remote.py +148 -13
  16. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/onprem_spec.py +80 -4
  17. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_onprem.py +39 -0
  18. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_onprem_remote.py +133 -1
  19. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/test_cli.py +58 -0
  20. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/.gitignore +0 -0
  21. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/CONTRIBUTING.md +0 -0
  22. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/LICENSE +0 -0
  23. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/deploy_docs/CONTRIBUTING.md +0 -0
  24. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/README.md +0 -0
  25. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/cli.md +0 -0
  26. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/dashboard.md +0 -0
  27. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/events.md +0 -0
  28. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/handlers.md +0 -0
  29. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/local-development.md +0 -0
  30. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/migrating-from-aws.md +0 -0
  31. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/docs/workflows.md +0 -0
  32. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/01-hello-http/README.md +0 -0
  33. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/01-hello-http/app/__init__.py +0 -0
  34. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/01-hello-http/app/handlers.py +0 -0
  35. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/01-hello-http/pskit.yml +0 -0
  36. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/01-hello-http/requirements.txt +0 -0
  37. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/02-rest-api/README.md +0 -0
  38. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/02-rest-api/app/__init__.py +0 -0
  39. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/02-rest-api/app/handlers.py +0 -0
  40. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/02-rest-api/app/store.py +0 -0
  41. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/02-rest-api/pskit.yml +0 -0
  42. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/02-rest-api/requirements.txt +0 -0
  43. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/03-scheduled-jobs/README.md +0 -0
  44. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/03-scheduled-jobs/app/__init__.py +0 -0
  45. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/03-scheduled-jobs/app/jobs.py +0 -0
  46. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/03-scheduled-jobs/pskit.yml +0 -0
  47. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/03-scheduled-jobs/requirements.txt +0 -0
  48. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/04-queue-worker/README.md +0 -0
  49. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/04-queue-worker/app/__init__.py +0 -0
  50. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/04-queue-worker/app/worker.py +0 -0
  51. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/04-queue-worker/pskit.yml +0 -0
  52. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/04-queue-worker/requirements.txt +0 -0
  53. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/05-storage-events/README.md +0 -0
  54. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/05-storage-events/app/__init__.py +0 -0
  55. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/05-storage-events/app/files.py +0 -0
  56. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/05-storage-events/pskit.yml +0 -0
  57. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/05-storage-events/requirements.txt +0 -0
  58. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/06-pubsub-topic/README.md +0 -0
  59. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/06-pubsub-topic/app/__init__.py +0 -0
  60. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/06-pubsub-topic/app/subscribers.py +0 -0
  61. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/06-pubsub-topic/pskit.yml +0 -0
  62. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/06-pubsub-topic/requirements.txt +0 -0
  63. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/07-workflow-orders/README.md +0 -0
  64. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/07-workflow-orders/app/__init__.py +0 -0
  65. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/07-workflow-orders/app/orders.py +0 -0
  66. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/07-workflow-orders/events/b2b.json +0 -0
  67. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/07-workflow-orders/events/declined.json +0 -0
  68. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/07-workflow-orders/events/happy.json +0 -0
  69. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/07-workflow-orders/pskit.yml +0 -0
  70. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/07-workflow-orders/requirements.txt +0 -0
  71. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/08-multi-cloud/README.md +0 -0
  72. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/08-multi-cloud/app/__init__.py +0 -0
  73. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/08-multi-cloud/app/handlers.py +0 -0
  74. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/08-multi-cloud/pskit.aws.yml +0 -0
  75. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/08-multi-cloud/pskit.azure.yml +0 -0
  76. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/08-multi-cloud/pskit.gcp.yml +0 -0
  77. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/08-multi-cloud/pskit.yml +0 -0
  78. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/08-multi-cloud/requirements.txt +0 -0
  79. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/09-function-invoke/README.md +0 -0
  80. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/09-function-invoke/app/__init__.py +0 -0
  81. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/09-function-invoke/app/quotes.py +0 -0
  82. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/09-function-invoke/pskit.yml +0 -0
  83. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/09-function-invoke/requirements.txt +0 -0
  84. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/10-stages-and-config/.env.example +0 -0
  85. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/10-stages-and-config/README.md +0 -0
  86. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/10-stages-and-config/app/__init__.py +0 -0
  87. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/10-stages-and-config/app/handlers.py +0 -0
  88. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/10-stages-and-config/app/settings.py +0 -0
  89. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/10-stages-and-config/config/limits.json +0 -0
  90. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/10-stages-and-config/pskit.yml +0 -0
  91. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/10-stages-and-config/requirements.txt +0 -0
  92. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/11-custom-terraform/README.md +0 -0
  93. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/11-custom-terraform/app/__init__.py +0 -0
  94. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/11-custom-terraform/app/handlers.py +0 -0
  95. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/11-custom-terraform/app/repository.py +0 -0
  96. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/11-custom-terraform/pskit.yml +0 -0
  97. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/11-custom-terraform/requirements.txt +0 -0
  98. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/11-custom-terraform/scripts/smoke_test.py +0 -0
  99. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/11-custom-terraform/tests/test_orders.py +0 -0
  100. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/12-async-and-context/README.md +0 -0
  101. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/12-async-and-context/app/__init__.py +0 -0
  102. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/12-async-and-context/app/handlers.py +0 -0
  103. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/12-async-and-context/pskit.yml +0 -0
  104. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/12-async-and-context/requirements.txt +0 -0
  105. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/13-migrate-from-aws-lambda/README.md +0 -0
  106. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/13-migrate-from-aws-lambda/after/app/__init__.py +0 -0
  107. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/13-migrate-from-aws-lambda/after/app/orders.py +0 -0
  108. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/13-migrate-from-aws-lambda/after/pskit.yml +0 -0
  109. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/13-migrate-from-aws-lambda/after/requirements.txt +0 -0
  110. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/13-migrate-from-aws-lambda/before/lambda_function.py +0 -0
  111. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/13-migrate-from-aws-lambda/before/state_machine.asl.json +0 -0
  112. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/13-migrate-from-aws-lambda/before/template.yaml +0 -0
  113. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/14-testing/README.md +0 -0
  114. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/14-testing/app/__init__.py +0 -0
  115. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/14-testing/app/handlers.py +0 -0
  116. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/14-testing/ci.github-workflow.yml +0 -0
  117. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/14-testing/pskit.yml +0 -0
  118. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/14-testing/requirements.txt +0 -0
  119. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/14-testing/tests/conftest.py +0 -0
  120. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/14-testing/tests/test_handlers.py +0 -0
  121. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/14-testing/tests/test_workflow.py +0 -0
  122. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/15-ci-cd-deploy/README.md +0 -0
  123. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/15-ci-cd-deploy/app/__init__.py +0 -0
  124. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/15-ci-cd-deploy/app/handlers.py +0 -0
  125. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/15-ci-cd-deploy/deploy.github-workflow.yml +0 -0
  126. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/15-ci-cd-deploy/pskit.yml +0 -0
  127. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/15-ci-cd-deploy/requirements.txt +0 -0
  128. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/16-on-premises/README.md +0 -0
  129. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/16-on-premises/app/__init__.py +0 -0
  130. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/16-on-premises/app/handlers.py +0 -0
  131. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/16-on-premises/pskit.yml +0 -0
  132. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/16-on-premises/requirements.txt +0 -0
  133. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/17-on-premises-remote/app/__init__.py +0 -0
  134. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/17-on-premises-remote/app/handlers.py +0 -0
  135. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/17-on-premises-remote/requirements.txt +0 -0
  136. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/examples/README.md +0 -0
  137. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/pyproject.toml +0 -0
  138. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/__init__.py +0 -0
  139. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/__main__.py +0 -0
  140. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/cli/__init__.py +0 -0
  141. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/config/__init__.py +0 -0
  142. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/config/loader.py +0 -0
  143. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/config/schema.py +0 -0
  144. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/core/__init__.py +0 -0
  145. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/core/deployer.py +0 -0
  146. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/core/describe.py +0 -0
  147. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/core/project.py +0 -0
  148. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/dashboard/__init__.py +0 -0
  149. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/dashboard/generator.py +0 -0
  150. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/dashboard/template.html +0 -0
  151. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/local/__init__.py +0 -0
  152. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/local/runner.py +0 -0
  153. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/local/server.py +0 -0
  154. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/packaging/__init__.py +0 -0
  155. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/packaging/builder.py +0 -0
  156. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/__init__.py +0 -0
  157. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/alibaba.py +0 -0
  158. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/aws.py +0 -0
  159. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/azure.py +0 -0
  160. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/base.py +0 -0
  161. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/cloudflare.py +0 -0
  162. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/digitalocean.py +0 -0
  163. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/gcp.py +0 -0
  164. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/huawei.py +0 -0
  165. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/ibm.py +0 -0
  166. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/oracle.py +0 -0
  167. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/registry.py +0 -0
  168. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/schedule.py +0 -0
  169. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/tencent.py +0 -0
  170. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/providers/terraform_doc.py +0 -0
  171. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/__init__.py +0 -0
  172. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/__init__.py +0 -0
  173. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/_httpfn.py +0 -0
  174. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/alibaba.py +0 -0
  175. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/aws.py +0 -0
  176. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/azure.py +0 -0
  177. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/base.py +0 -0
  178. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/cloudflare.py +0 -0
  179. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/digitalocean.py +0 -0
  180. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/gcp.py +0 -0
  181. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/huawei.py +0 -0
  182. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/ibm.py +0 -0
  183. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/onprem.py +0 -0
  184. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/oracle.py +0 -0
  185. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/adapters/tencent.py +0 -0
  186. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/batch.py +0 -0
  187. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/context.py +0 -0
  188. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/cron.py +0 -0
  189. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/dispatch.py +0 -0
  190. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/errors.py +0 -0
  191. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/event.py +0 -0
  192. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/invoke.py +0 -0
  193. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/log.py +0 -0
  194. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/manifest.py +0 -0
  195. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/onprem_host.py +0 -0
  196. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/response.py +0 -0
  197. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/routing.py +0 -0
  198. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/runtime/workflow.py +0 -0
  199. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/terraform/__init__.py +0 -0
  200. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/terraform/runner.py +0 -0
  201. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/workflows/__init__.py +0 -0
  202. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/workflows/asl.py +0 -0
  203. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/src/py_serverless_kit/workflows/gcp.py +0 -0
  204. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/__init__.py +0 -0
  205. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/config/__init__.py +0 -0
  206. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/config/test_loader.py +0 -0
  207. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/config/test_schema.py +0 -0
  208. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/conftest.py +0 -0
  209. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/local/__init__.py +0 -0
  210. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/local/test_server.py +0 -0
  211. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/__init__.py +0 -0
  212. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_alibaba.py +0 -0
  213. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_aws.py +0 -0
  214. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_azure.py +0 -0
  215. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_cloudflare.py +0 -0
  216. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_digitalocean.py +0 -0
  217. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_gcp.py +0 -0
  218. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_huawei.py +0 -0
  219. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_ibm.py +0 -0
  220. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_oracle.py +0 -0
  221. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_schedule.py +0 -0
  222. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/providers/test_tencent.py +0 -0
  223. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/__init__.py +0 -0
  224. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_alibaba.py +0 -0
  225. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_aws.py +0 -0
  226. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_azure.py +0 -0
  227. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_cloudflare.py +0 -0
  228. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_digitalocean.py +0 -0
  229. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_gcp.py +0 -0
  230. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_huawei.py +0 -0
  231. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_ibm.py +0 -0
  232. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_onprem.py +0 -0
  233. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_oracle.py +0 -0
  234. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_adapter_tencent.py +0 -0
  235. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_cron.py +0 -0
  236. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_dispatch.py +0 -0
  237. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_models.py +0 -0
  238. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_onprem_host.py +0 -0
  239. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/runtime/test_workflow_engine.py +0 -0
  240. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/test_dashboard.py +0 -0
  241. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/test_examples.py +0 -0
  242. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/test_packaging.py +0 -0
  243. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/workflows/__init__.py +0 -0
  244. {py_serverless_kit-0.3.0 → py_serverless_kit-0.4.0}/tests/workflows/test_compilers.py +0 -0
@@ -6,6 +6,13 @@ All notable changes to this project are documented here. The format follows [Kee
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.4.0] - 2026-10-19
10
+
11
+ ### Added
12
+ - On-premises Docker deploy to a server. Set `options.deploy.method: docker` and `options.deploy.host`. `pskit deploy` asks for a `.pem` private key when `options.deploy.pem` is unset (`identity_file` is the same field). The image is built on the machine that runs `pskit`, copied over SSH, and started with `docker run`. If `docker` is missing on the server, apply installs it (`docker.io` via apt, `docker` via dnf or yum, or `docker` via apk) and then loads the image. `install_docker: false` skips the install and fails if Docker is absent. `sudo` defaults to true for this path so the SSH user can install and start the daemon.
13
+
14
+ Redeploy on-premises Docker hosts to pick up the new provisioner. Handler code is unchanged.
15
+
9
16
  ## [0.3.0] - 2026-10-17
10
17
 
11
18
  ### Added
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: py-serverless-kit
3
- Version: 0.3.0
3
+ Version: 0.4.0
4
4
  Summary: Write a Python serverless function once and deploy it to AWS, Azure, GCP, 7 more clouds, or an on-premises host with one YAML file, powered by Terraform.
5
5
  Project-URL: Homepage, https://github.com/ak9347128658/serverless_kit
6
6
  Project-URL: Documentation, https://github.com/ak9347128658/serverless_kit/tree/main/docs
@@ -97,7 +97,7 @@ Teams that build on AWS Lambda and Step Functions end up with code full of API G
97
97
 
98
98
  ## Features
99
99
 
100
- - **10 clouds and an on-premises host:** AWS Lambda, Azure Functions, Google Cloud Functions (gen2), Alibaba Function Compute, Oracle Functions, IBM Code Engine, DigitalOcean Functions, Tencent SCF, Huawei FunctionGraph, Cloudflare Workers, plus a process on your own machine or a remote server (`onprem`: local, SSH, Docker, or a bundled CPython when the server has no Python).
100
+ - **10 clouds and an on-premises host:** AWS Lambda, Azure Functions, Google Cloud Functions (gen2), Alibaba Function Compute, Oracle Functions, IBM Code Engine, DigitalOcean Functions, Tencent SCF, Huawei FunctionGraph, Cloudflare Workers, plus a process on your own machine or a remote server (`onprem`: local, SSH, Docker with a `.pem` — the image is built locally and Docker is installed on the server when it is missing — or a bundled CPython when the server has no Python).
101
101
  - **Triggers:** HTTP (path params, CORS, auth), schedules (rate/cron, translated into each cloud's cron dialect), queues, object storage, pub/sub topics, and direct function-to-function `invoke()`.
102
102
  - **Workflows:** task / choice / wait / pass / parallel / map / succeed / fail with retry and catch. Native on AWS and GCP; an embedded engine on the other clouds; runnable locally with `pskit workflow run`.
103
103
  - **Terraform underneath:** real, reviewable `main.tf.json`, any backend (S3, GCS, azurerm, ...), works with OpenTofu. Escape hatches: `terraform.extra`, `${tf:...}` references, per-function `options`.
@@ -53,7 +53,7 @@ Teams that build on AWS Lambda and Step Functions end up with code full of API G
53
53
 
54
54
  ## Features
55
55
 
56
- - **10 clouds and an on-premises host:** AWS Lambda, Azure Functions, Google Cloud Functions (gen2), Alibaba Function Compute, Oracle Functions, IBM Code Engine, DigitalOcean Functions, Tencent SCF, Huawei FunctionGraph, Cloudflare Workers, plus a process on your own machine or a remote server (`onprem`: local, SSH, Docker, or a bundled CPython when the server has no Python).
56
+ - **10 clouds and an on-premises host:** AWS Lambda, Azure Functions, Google Cloud Functions (gen2), Alibaba Function Compute, Oracle Functions, IBM Code Engine, DigitalOcean Functions, Tencent SCF, Huawei FunctionGraph, Cloudflare Workers, plus a process on your own machine or a remote server (`onprem`: local, SSH, Docker with a `.pem` — the image is built locally and Docker is installed on the server when it is missing — or a bundled CPython when the server has no Python).
57
57
  - **Triggers:** HTTP (path params, CORS, auth), schedules (rate/cron, translated into each cloud's cron dialect), queues, object storage, pub/sub topics, and direct function-to-function `invoke()`.
58
58
  - **Workflows:** task / choice / wait / pass / parallel / map / succeed / fail with retry and catch. Native on AWS and GCP; an embedded engine on the other clouds; runnable locally with `pskit workflow run`.
59
59
  - **Terraform underneath:** real, reviewable `main.tf.json`, any backend (S3, GCS, azurerm, ...), works with OpenTofu. Escape hatches: `terraform.extra`, `${tf:...}` references, per-function `options`.
@@ -49,7 +49,7 @@ artifact.zip
49
49
  └── dependencies or requirements.txt
50
50
  ```
51
51
 
52
- On-premises also writes `.pskit/onprem-<stage>/onprem_app/` (`pskit_host.json`, `onprem_ctl.py`, `onprem_deploy.py`, the staged bundle, and a Dockerfile or systemd unit when those methods are selected). Terraform `local-exec` runs `onprem_deploy.py apply`, which starts the host on this machine, copies it over SSH (detached process or systemd, optional portable CPython), or builds a Docker image.
52
+ On-premises also writes `.pskit/onprem-<stage>/onprem_app/` (`pskit_host.json`, `onprem_ctl.py`, `onprem_deploy.py`, the staged bundle, and a Dockerfile or systemd unit when those methods are selected). Terraform `local-exec` runs `onprem_deploy.py apply`, which starts the host on this machine, copies it over SSH (detached process or systemd, optional portable CPython), or builds a Docker image. A remote Docker target builds that image locally, installs Docker on the server when `docker` is missing, then copies the image with the configured `.pem` and runs it.
53
53
 
54
54
  ## Runtime flow
55
55
 
@@ -45,7 +45,7 @@ extends: base.yml # inherit another file (see below)
45
45
  | `iam.statements` | list of `{effect, actions, resources}` | `[]` | AWS-style; `effect` defaults to `Allow`, `resources` to `["*"]`. Ignored (with a warning) on clouds that don't map it |
46
46
  | `iam.role` | string | — | use an existing role / agency instead of creating one |
47
47
  | `log_retention_days` | int or null | `14` | AWS CloudWatch log group retention |
48
- | `options` | mapping | `{}` | provider-specific settings, see [providers.md](providers.md). On-premises: `deploy.method` is `local`, `ssh`, or `docker`; `python: bundle` ships an interpreter when the server has none |
48
+ | `options` | mapping | `{}` | provider-specific settings, see [providers.md](providers.md). On-premises: `deploy.method` is `local`, `ssh`, or `docker`; remote Docker uses `deploy.host` and `deploy.pem` (a `.pem` key; `pskit deploy` asks when it is missing) and installs Docker on the server when it is absent. `python: bundle` ships an interpreter when the server has none |
49
49
  | `state` | mapping | local state | see [state](#state-remote-terraform-backend) |
50
50
  | `terraform` | mapping | | see [terraform](#terraform) |
51
51
 
@@ -109,7 +109,7 @@ pskit runs Terraform, so credentials come from each Terraform provider's standar
109
109
  | `tencent` | `TENCENTCLOUD_SECRET_ID` / `TENCENTCLOUD_SECRET_KEY`, or `options.profile` |
110
110
  | `huawei` | `HW_ACCESS_KEY` / `HW_SECRET_KEY` (+ `HW_REGION_NAME`), or `options.profile` |
111
111
  | `cloudflare` | `CLOUDFLARE_API_TOKEN`. `options.account_id` is required |
112
- | `onprem` | local: nothing to configure (the Python that runs `pskit` starts the host). Remote: OpenSSH and `options.deploy.method: ssh`, or Docker and `method: docker`. Servers without Python: `python: bundle` or Docker |
112
+ | `onprem` | local: nothing to configure (the Python that runs `pskit` starts the host). Remote: OpenSSH and `options.deploy.method: ssh`, or Docker with `method: docker`, `host`, and a `.pem` (`pem`). `pskit deploy` asks for the `.pem` when it is missing, builds the image locally, installs Docker on the server if needed, and runs the container. Servers without Python: `python: bundle` or Docker |
113
113
 
114
114
  Provider-specific required options are listed in [providers.md](providers.md).
115
115
 
@@ -357,7 +357,7 @@ One Worker script per function. pskit generates a single Python module per Worke
357
357
  ## onprem (On-premises)
358
358
 
359
359
  - **Terraform:** built-in `terraform_data` (no plugin download). Create/destroy run `onprem_deploy.py` via `local-exec`
360
- - **Credentials:** none for `method: local`. SSH keys / an SSH agent for `method: ssh`. Docker CLI (and optional `DOCKER_HOST`) for `method: docker`
360
+ - **Credentials:** none for `method: local`. SSH keys / an SSH agent for `method: ssh`. For `method: docker` on a server, a `.pem` private key (`options.deploy.pem`) plus OpenSSH on the laptop and a Docker CLI to build the image. `pskit deploy` asks for the `.pem` when it is not set. `docker_host: tcp://`, `unix://`, or `npipe://` still talks to that daemon and does not use SSH
361
361
  - **Dependencies:** native pip wheels for a local host; manylinux / Windows / macOS wheels matching `deploy.target_os` and `architecture` for a remote host. `tzdata` is vendored so cron timezones work on Windows
362
362
 
363
363
  ```yaml
@@ -414,7 +414,7 @@ From a handler in that process (`PSKIT_ONPREM_ROOT` is set), call `submit_queue`
414
414
  |---|---|---|---|
415
415
  | `local` (default) | detached process on this machine | Python (the interpreter that runs `pskit`) | — |
416
416
  | `ssh` | process or systemd unit on a remote host | SSH. Python only if `python: system` | OpenSSH (`ssh`, `scp`) |
417
- | `docker` | `docker build` + `docker run` | Docker engine, not Python | Docker CLI; set `docker_host: ssh://user@host` to use a remote daemon |
417
+ | `docker` | image built on this machine, then `docker load` + `docker run` on the server | SSH. Docker is installed at apply when it is missing (`install_docker: true`, the default) | Docker CLI and OpenSSH. `pem` is the server private key |
418
418
 
419
419
  When the server has **no Python**, use `python: bundle` (a portable CPython from [python-build-standalone](https://github.com/astral-sh/python-build-standalone) is fetched at apply and copied with the app) or `method: docker` (the image is `FROM python:<minor>-slim`). Air-gapped: `python_home` (copy a tree you already have) or `python_url` + `python_sha256` (internal mirror of an `install_only` tarball).
420
420
 
@@ -434,15 +434,29 @@ deploy:
434
434
  install: systemd # process | systemd (linux only)
435
435
  sudo: true # needed to write /etc/systemd/system
436
436
 
437
- # Docker (server needs Docker, not Python)
437
+ # Docker on a server. The image is built here, copied with the .pem, and run there.
438
+ # `pskit deploy` asks for the .pem when `pem` is empty. Docker is installed on the
439
+ # server first when `docker` is not already on PATH (apt/dnf/yum/apk).
438
440
  deploy:
439
441
  method: docker
442
+ host: 10.0.1.12
443
+ user: pskit
444
+ port: 22
445
+ pem: ${env:PSKIT_SSH_KEY} # or identity_file; path to the .pem
440
446
  image: pskit/orders:dev
441
- docker_host: ssh://pskit@10.0.1.12 # empty = Docker on this laptop
447
+ install_docker: true # default for a remote host
448
+ sudo: true # default; needed to install and start dockerd
442
449
  restart: unless-stopped
450
+
451
+ # Docker on this laptop only (no SSH, no .pem)
452
+ deploy:
453
+ method: docker
454
+ image: pskit/orders:dev
443
455
  ```
444
456
 
445
- `options.host` is the bind address **on the target**. Use `0.0.0.0` so other machines can call a remote host. `advertise` is the URL stored in `pskit info`. SSH deploy defaults `advertise` to `http://<ssh host>:<port>` when it is unset.
457
+ `options.host` is the bind address **on the target**. Use `0.0.0.0` so other machines can call a remote host. `advertise` is the URL stored in `pskit info`. SSH and remote Docker deploys default `advertise` to `http://<server>:<port>` when it is unset.
458
+
459
+ Remote Docker (`method: docker` plus `host`, or `docker_host: ssh://user@host`) builds `pskit-<service>-<stage>` locally, saves it to a tar, and `scp`s that tar to `pskit-images/<container>/` in the SSH user's home. Apply then runs `docker load` and `docker run`, and deletes the tar. The SSH user needs passwordless `sudo` when Docker must be installed or when the user cannot talk to the daemon (`sudo` defaults to true). The `.pem` must be accepted by `ssh -o BatchMode=yes` (no passphrase prompt). Set `install_docker: false` to refuse a server that does not already have Docker. A server whose package manager is not apt, dnf, yum, or apk is reported and left unchanged.
446
460
 
447
461
  **Resources:** `terraform_data.host` with create (`onprem_deploy.py apply`) and destroy (`onprem_deploy.py destroy`) `local-exec` provisioners.
448
462
 
@@ -82,7 +82,7 @@ Add `-v` to any command to see the full traceback. Start with `pskit validate`,
82
82
  | digitalocean | `doctl` must be installed and authenticated (`doctl auth init`); `options.namespace` required; set `options.api_host` to get URLs |
83
83
  | ibm | HTTP only, python3.11 only, 120 s / 4 GB max; large bundles → `options.code_reference` |
84
84
  | cloudflare | Pyodide: only stdlib and Pyodide packages; `options.account_id` and `CLOUDFLARE_API_TOKEN` required; non-`.py` files aren't uploaded |
85
- | onprem | one process per service, so give each service its own `options.port`. `pskit remove` stops it and leaves `data_dir`. `auth` must be `none`. A cloud `terraform.extra` resource is omitted. Set `state.backend` empty when the file points at S3, GCS or Azure Storage. Remote SSH needs `ssh`/`scp` on the laptop; a server without Python needs `deploy.python: bundle` or `method: docker`. systemd writes `/etc/systemd/system` (`sudo: true`). Bind `options.host: 0.0.0.0` on a remote host so other machines can call it |
85
+ | onprem | one process per service, so give each service its own `options.port`. `pskit remove` stops it and leaves `data_dir`. `auth` must be `none`. A cloud `terraform.extra` resource is omitted. Set `state.backend` empty when the file points at S3, GCS or Azure Storage. Remote SSH needs `ssh`/`scp` on the laptop; a server without Python needs `deploy.python: bundle` or `method: docker`. Remote Docker needs `deploy.pem` (asked at `pskit deploy` when unset) and builds the image locally. If the server has no `docker` command, apply installs it with apt, dnf, yum, or apk (`sudo: true`) and then loads the image. The `.pem` must work with `BatchMode` (no passphrase prompt) and must not be group-readable or OpenSSH will reject it. systemd writes `/etc/systemd/system` (`sudo: true`). Bind `options.host: 0.0.0.0` on a remote host so other machines can call it |
86
86
  | alibaba / tencent / huawei | `iam.statements` aren't translated; set `iam.role` |
87
87
 
88
88
  ## FAQ
@@ -10,15 +10,16 @@ Three ways to get code from this laptop onto that server:
10
10
  | --- | --- | --- | --- |
11
11
  | `local` | this machine (example 16) | Python + pskit | laptop / the server *is* the deploy machine |
12
12
  | `ssh` | SSH. Python only if `python: system` | OpenSSH (`ssh`, `scp`) | most on-prem Linux boxes |
13
- | `docker` | Docker engine | Docker CLI (and SSH if `docker_host` is `ssh://…`) | the server has Docker and you do not want to manage Python |
13
+ | `docker` | SSH. Docker is installed at deploy when it is missing | Docker CLI, OpenSSH, and a `.pem` for the server | the server should run a container, with or without Docker already installed |
14
14
 
15
15
  When the server has **no Python**, pick one of:
16
16
 
17
17
  - `method: ssh` and `python: bundle` — pskit downloads a portable CPython
18
18
  ([python-build-standalone](https://github.com/astral-sh/python-build-standalone))
19
19
  at apply time, copies it with the app, and starts systemd (this file)
20
- - `method: docker` — the image is `FROM python:3.12-slim`; the server never
21
- installs Python
20
+ - `method: docker` — the image is `FROM python:3.12-slim` and is built on this
21
+ machine. The server does not need Python. If it also has no Docker, deploy
22
+ installs Docker and then loads the image
22
23
  - `python_home: /path/to/portable-python` — air-gapped: you already have a
23
24
  CPython tree, pskit copies it instead of downloading
24
25
 
@@ -45,7 +46,10 @@ deploy: ssh://pskit@10.0.1.12/opt/pskit/factory-api
45
46
 
46
47
  ## Docker instead
47
48
 
48
- The server needs a Docker engine. It does not need Python.
49
+ The image is built on the laptop. It is copied to the server with the `.pem`
50
+ and started there. The server does not need Python. If `docker` is not on the
51
+ server, deploy installs it (apt, dnf, yum, or apk) and then loads the image.
52
+ `pskit deploy` asks for the `.pem` path when `pem` is empty.
49
53
 
50
54
  ```yaml
51
55
  provider:
@@ -54,13 +58,21 @@ provider:
54
58
  port: 8090
55
59
  deploy:
56
60
  method: docker
61
+ host: 10.0.1.12
62
+ user: pskit
63
+ pem: ~/.ssh/factory.pem
57
64
  image: pskit/factory-api:dev
58
- docker_host: ssh://pskit@10.0.1.12 # empty = Docker on this laptop
59
65
  restart: unless-stopped
60
66
  ```
61
67
 
62
- `pskit deploy` runs `docker build` and `docker run` (with `DOCKER_HOST` when
63
- `docker_host` is set). Data lives in a volume named after the container.
68
+ ```bash
69
+ pskit deploy
70
+ # Path to the SSH private key (.pem): C:\keys\factory.pem
71
+ ```
72
+
73
+ Leave out `host` to build and run the container on the laptop instead. Data
74
+ lives in a volume named after the container. The SSH user needs passwordless
75
+ `sudo` when Docker has to be installed.
64
76
 
65
77
  ## Server already has Python
66
78
 
@@ -10,9 +10,10 @@
10
10
  # set PSKIT_ONPREM_HOST=10.0.1.12
11
11
  # pskit deploy
12
12
  #
13
- # Switch to Docker (server needs Docker, not Python) with the `providers.onprem`
14
- # block left as-is and:
15
- # pskit deploy after changing deploy.method to docker (see README).
13
+ # Switch to Docker (image built on this machine, run on the server) by replacing
14
+ # deploy.method with docker and setting pem to the server .pem. pskit deploy
15
+ # asks for that path when pem is empty, installs Docker on the server if the
16
+ # `docker` command is missing, then loads and runs the image. See the README.
16
17
  service: factory-api
17
18
 
18
19
  provider:
@@ -1,2 +1,2 @@
1
- __version__ = "0.3.0"
1
+ __version__ = "0.4.0"
2
2
  __author__ = "Asif Khan @ Kavion.ai"
@@ -198,6 +198,7 @@ def deploy(project, skip_deps: bool, confirm: bool, upgrade: bool, no_dashboard:
198
198
  from ..core.deployer import Deployer
199
199
  from ..dashboard.generator import write_dashboard
200
200
 
201
+ _ask_onprem_pem(project)
201
202
  record = Deployer(project, echo=echo).deploy(skip_deps=skip_deps, auto_approve=not confirm, upgrade=upgrade)
202
203
  ok(f"\nDeployed {record['service']} ({record['stage']}) to {record['provider_display']} {record['region']}")
203
204
  _print_record(record)
@@ -225,6 +226,42 @@ def remove(project, yes: bool) -> None: # noqa: ANN001
225
226
  ok("Removed.")
226
227
 
227
228
 
229
+ def _ask_onprem_pem(project: Any) -> None:
230
+ """Ask for the server ``.pem`` when a remote Docker deploy has none yet."""
231
+ if project.config.provider.name != "onprem":
232
+ return
233
+ from ..providers.onprem_spec import assign_pem, parse_deploy, targets_remote_docker
234
+
235
+ cfg = project.config
236
+ try:
237
+ spec = parse_deploy(
238
+ cfg.provider.options,
239
+ service=cfg.service,
240
+ stage=cfg.provider.stage,
241
+ runtime=cfg.provider.runtime,
242
+ architecture=cfg.provider.architecture,
243
+ )
244
+ except ValueError:
245
+ return
246
+ if not targets_remote_docker(spec):
247
+ return
248
+ if spec.identity_file and os.path.isfile(spec.identity_file):
249
+ return
250
+ who = f"{spec.ssh_user}@{spec.ssh_host}" if spec.ssh_user else spec.ssh_host
251
+ if not sys.stdin.isatty():
252
+ raise click.ClickException(
253
+ "on-premises Docker deploy needs a .pem private key for "
254
+ f"{who}. Set options.deploy.pem in pskit.yml (or PSKIT_SSH_KEY) and run pskit deploy again."
255
+ )
256
+ echo(f"On-premises Docker deploy builds an image on this machine and copies it to {who}.")
257
+ echo("If Docker is not installed on that server, it is installed before the image is loaded.")
258
+ entered = click.prompt(
259
+ "Path to the SSH private key (.pem)",
260
+ type=click.Path(exists=True, dir_okay=False, readable=True),
261
+ )
262
+ assign_pem(cfg.provider.options, str(entered))
263
+
264
+
228
265
  # ----------------------------------------------------------------------------- info / dashboard
229
266
  def _print_record(record: dict) -> None:
230
267
  if record.get("endpoint"):
@@ -33,6 +33,7 @@ PROVIDER_OPTIONS = {
33
33
  " port: 8080\n"
34
34
  " # deploy.method: local (this machine) | ssh | docker\n"
35
35
  " # ssh: {host: 10.0.1.12, user: pskit, python: bundle, install: systemd}\n"
36
+ " # docker on a server: {method: docker, host: 10.0.1.12, user: pskit, pem: ./server.pem}\n"
36
37
  " # python: bundle ships a portable CPython when the server has none\n"
37
38
  " # builtin services are created on deploy. To use a directory you already\n"
38
39
  " # have: storage: {use: directory, path: /var/pskit/buckets}\n"
@@ -8,7 +8,10 @@ provisioner (no cloud plugin, no extra broker to install).
8
8
 
9
9
  * ``local`` — this machine, same as earlier releases (the default)
10
10
  * ``ssh`` — copy the bundle over OpenSSH and start it (process or systemd)
11
- * ``docker`` — build an image that already contains Python and run a container
11
+ * ``docker`` — build an image that already contains Python and run a container.
12
+ With ``host`` (or ``docker_host: ssh://...``) the image is built on this
13
+ machine, copied over SSH with a ``.pem`` key, and started on the server.
14
+ Docker is installed on that server first when it is not already there.
12
15
 
13
16
  When the target has no Python, set ``deploy.python: bundle`` (a portable
14
17
  CPython is downloaded at apply and copied with the app) or ``method: docker``.
@@ -44,6 +47,7 @@ from .onprem_spec import (
44
47
  parse_deploy,
45
48
  pip_flags,
46
49
  python_bin_for,
50
+ targets_remote_docker,
47
51
  unit_name,
48
52
  validate_identity,
49
53
  )
@@ -122,7 +126,9 @@ class OnPremProvider(Provider):
122
126
  notes = (
123
127
  "Runs a long-lived Python process. Default `options.deploy.method` is `local` "
124
128
  "(this machine). `ssh` copies the bundle with OpenSSH; `docker` builds an image "
125
- "that includes Python so the server does not need an interpreter. "
129
+ "that includes Python. A remote Docker host (`deploy.host` or `docker_host: ssh://`) "
130
+ "asks for a `.pem` key, builds the image locally, installs Docker on the server "
131
+ "when it is missing, then loads and runs the image. "
126
132
  "`python: bundle` ships a portable CPython for hosts without Python. "
127
133
  "HTTP, schedules, file-backed queues, directory storage, topics and embedded "
128
134
  "workflows all run in that process. Set provider.options.services.<kind> to "
@@ -199,7 +205,21 @@ class OnPremProvider(Provider):
199
205
  if spec is not None:
200
206
  missing = validate_identity(spec)
201
207
  if missing:
202
- issues.append(Issue("warning", missing, "provider.options.deploy.identity_file"))
208
+ where = (
209
+ "provider.options.deploy.pem"
210
+ if targets_remote_docker(spec)
211
+ else "provider.options.deploy.identity_file"
212
+ )
213
+ issues.append(Issue("warning", missing, where))
214
+ if targets_remote_docker(spec) and spec.install_docker and not spec.sudo:
215
+ issues.append(
216
+ Issue(
217
+ "warning",
218
+ "installing Docker on the server uses sudo unless the SSH user is root. "
219
+ "Set options.deploy.sudo: true.",
220
+ "provider.options.deploy.sudo",
221
+ )
222
+ )
203
223
  running = f"python{sys.version_info.major}.{sys.version_info.minor}"
204
224
  if spec.method == "local" and spec.python == "system" and config.provider.runtime != running:
205
225
  issues.append(
@@ -398,6 +418,10 @@ class OnPremProvider(Provider):
398
418
  cfg = ctx.config
399
419
  options = cfg.provider.options
400
420
  spec = self._deploy(cfg)
421
+ if spec.identity_file:
422
+ ident = Path(spec.identity_file)
423
+ if not ident.is_absolute():
424
+ spec.identity_file = str((ctx.root / ident).resolve())
401
425
  host = str(options.get("host") or "127.0.0.1")
402
426
  port = int(options.get("port") or 8080)
403
427
  if spec.method == "docker" and host in ("127.0.0.1", "localhost"):
@@ -2,13 +2,17 @@
2
2
 
3
3
  Terraform ``local-exec`` runs this with the same interpreter as ``pskit deploy``.
4
4
  The target never needs pskit installed. ``python: bundle`` ships a portable
5
- CPython; ``method: docker`` ships an image that already contains Python.
5
+ CPython; ``method: docker`` builds an image that already contains Python.
6
+ A remote Docker target (``host`` or ``docker_host: ssh://...``) builds that
7
+ image on this machine, installs Docker on the server when it is missing, then
8
+ copies the image over SSH and runs it.
6
9
  """
7
10
 
8
11
  from __future__ import annotations
9
12
 
10
13
  import hashlib
11
14
  import os
15
+ import re
12
16
  import shutil
13
17
  import subprocess
14
18
  import sys
@@ -18,7 +22,7 @@ from typing import Any, Callable, Dict, List, Optional, Sequence
18
22
  from urllib.error import URLError
19
23
  from urllib.request import Request, urlopen
20
24
 
21
- from .onprem_spec import python_bin_for
25
+ from .onprem_spec import json_targets_remote_docker, python_bin_for
22
26
 
23
27
  _CACHE = Path(os.environ.get("PSKIT_CACHE_DIR") or (Path.home() / ".cache" / "pskit"))
24
28
  RunFn = Callable[..., "subprocess.CompletedProcess[Any]"]
@@ -117,35 +121,162 @@ def destroy_ssh(root: Path, spec: Dict[str, Any], *, run: Optional[RunFn] = None
117
121
 
118
122
 
119
123
  def apply_docker(root: Path, spec: Dict[str, Any], *, run: Optional[RunFn] = None) -> None:
120
- docker = spec["deploy"]["docker"]
124
+ deploy = spec["deploy"]
125
+ if json_targets_remote_docker(deploy):
126
+ apply_docker_remote(root, spec, run=run)
127
+ return
128
+ docker = deploy["docker"]
121
129
  env = _docker_env(docker.get("host") or "")
122
130
  image = docker["image"]
123
131
  container = docker["container"]
124
132
  _run(["docker", "build", "-t", image, "."], cwd=root, run=run, env=env)
125
133
  _run(["docker", "rm", "-f", container], cwd=root, run=run, env=env, check=False)
126
- publish = docker.get("publish") or f"{spec.get('port') or 8080}:{spec.get('port') or 8080}"
134
+ _run(_docker_run_argv(docker, spec), cwd=root, run=run, env=env)
135
+
136
+
137
+ def apply_docker_remote(root: Path, spec: Dict[str, Any], *, run: Optional[RunFn] = None) -> None:
138
+ """Build on this machine, install Docker on the server if needed, then load and run."""
139
+ deploy = spec["deploy"]
140
+ docker = deploy["docker"]
141
+ ssh = deploy["ssh"]
142
+ image = str(docker["image"])
143
+ identity = str(ssh.get("identity_file") or "")
144
+ if not identity:
145
+ raise DeployError(
146
+ "remote Docker deploy needs a .pem private key. "
147
+ "Set options.deploy.pem, or run `pskit deploy` in a terminal and enter the path."
148
+ )
149
+ if not os.path.isfile(identity):
150
+ raise DeployError(f"SSH private key not found: {identity}")
151
+ _run(["docker", "build", "-t", image, "."], cwd=root, run=run)
152
+ tar_path = root / "image.tar"
153
+ try:
154
+ _run(["docker", "save", "-o", str(tar_path), image], cwd=root, run=run)
155
+ remote_tar = _remote_tar(str(docker["container"]))
156
+ remote_dir = remote_tar.rsplit("/", 1)[0]
157
+ install = bool(docker.get("install_docker", True))
158
+ _ssh(ssh, _docker_setup_script(install=install, remote_dir=remote_dir), run=run)
159
+ _scp(ssh, tar_path, remote_tar, run=run)
160
+ _ssh(ssh, _docker_load_script(docker, spec, remote_tar), run=run)
161
+ finally:
162
+ if tar_path.is_file():
163
+ tar_path.unlink()
164
+
165
+
166
+ def destroy_docker(root: Path, spec: Dict[str, Any], *, run: Optional[RunFn] = None) -> None:
167
+ deploy = spec["deploy"]
168
+ docker = deploy["docker"]
169
+ if json_targets_remote_docker(deploy):
170
+ ssh = deploy["ssh"]
171
+ container = str(docker["container"])
172
+ script = _docker_shell_header() + f"dk rm -f {_shq(container)} || true\n"
173
+ _ssh(ssh, script, run=run, check=False)
174
+ return
175
+ env = _docker_env(docker.get("host") or "")
176
+ _run(["docker", "rm", "-f", docker["container"]], cwd=root, run=run, env=env, check=False)
177
+
178
+
179
+ def _docker_run_argv(docker: Dict[str, Any], spec: Dict[str, Any]) -> List[str]:
180
+ publish = str(docker.get("publish") or f"{spec.get('port') or 8080}:{spec.get('port') or 8080}")
127
181
  argv = [
128
182
  "docker",
129
183
  "run",
130
184
  "-d",
131
185
  "--name",
132
- container,
186
+ str(docker["container"]),
133
187
  "--restart",
134
188
  str(docker.get("restart") or "unless-stopped"),
135
189
  "-p",
136
190
  publish,
137
191
  "-v",
138
- f"{container}-data:/var/pskit/data",
192
+ f"{docker['container']}-data:/var/pskit/data",
139
193
  ]
140
194
  argv.extend(str(item) for item in (docker.get("args") or []))
141
- argv.append(image)
142
- _run(argv, cwd=root, run=run, env=env)
195
+ argv.append(str(docker["image"]))
196
+ return argv
143
197
 
144
198
 
145
- def destroy_docker(root: Path, spec: Dict[str, Any], *, run: Optional[RunFn] = None) -> None:
146
- docker = spec["deploy"]["docker"]
147
- env = _docker_env(docker.get("host") or "")
148
- _run(["docker", "rm", "-f", docker["container"]], cwd=root, run=run, env=env, check=False)
199
+ def _remote_tar(container: str) -> str:
200
+ slug = re.sub(r"[^A-Za-z0-9._-]+", "-", container).strip("-") or "pskit"
201
+ # Home-relative so the SSH user can write it, and so it is not a shared temp dir.
202
+ return f"pskit-images/{slug}/image.tar"
203
+
204
+
205
+ def _docker_shell_header() -> str:
206
+ return (
207
+ "set -eu\n"
208
+ "as_root() { if [ \"$(id -u)\" -eq 0 ]; then \"$@\"; else sudo \"$@\"; fi; }\n"
209
+ "dk() { if docker info >/dev/null 2>&1; then docker \"$@\"; else as_root docker \"$@\"; fi; }\n"
210
+ )
211
+
212
+
213
+ def _docker_setup_script(*, install: bool, remote_dir: str) -> str:
214
+ """Create the staging directory and install Docker when the server does not have it."""
215
+ lines = [_docker_shell_header(), f"mkdir -p {_shq(remote_dir)}\n"]
216
+ if install:
217
+ lines.append(
218
+ "if ! command -v docker >/dev/null 2>&1; then\n"
219
+ " if command -v apt-get >/dev/null 2>&1; then\n"
220
+ " export DEBIAN_FRONTEND=noninteractive\n"
221
+ " as_root apt-get update\n"
222
+ " as_root apt-get install -y docker.io\n"
223
+ " elif command -v dnf >/dev/null 2>&1; then\n"
224
+ " as_root dnf install -y docker\n"
225
+ " elif command -v yum >/dev/null 2>&1; then\n"
226
+ " as_root yum install -y docker\n"
227
+ " elif command -v apk >/dev/null 2>&1; then\n"
228
+ " as_root apk add --no-cache docker\n"
229
+ " else\n"
230
+ ' echo "pskit: Docker is not installed and this server has no apt-get, dnf, yum, or apk" >&2\n'
231
+ " exit 1\n"
232
+ " fi\n"
233
+ " if command -v systemctl >/dev/null 2>&1; then\n"
234
+ " as_root systemctl enable --now docker || as_root service docker start || true\n"
235
+ " elif command -v service >/dev/null 2>&1; then\n"
236
+ " as_root service docker start || true\n"
237
+ " fi\n"
238
+ "fi\n"
239
+ )
240
+ lines.append(
241
+ "if ! command -v docker >/dev/null 2>&1; then\n"
242
+ ' echo "pskit: Docker is not installed on the server. Set options.deploy.install_docker: true or install it, then redeploy." >&2\n'
243
+ " exit 1\n"
244
+ "fi\n"
245
+ "dk info >/dev/null\n"
246
+ )
247
+ return "".join(lines)
248
+
249
+
250
+ def _docker_load_script(docker: Dict[str, Any], spec: Dict[str, Any], remote_tar: str) -> str:
251
+ publish = str(docker.get("publish") or f"{spec.get('port') or 8080}:{spec.get('port') or 8080}")
252
+ restart = str(docker.get("restart") or "unless-stopped")
253
+ container = str(docker["container"])
254
+ image = str(docker["image"])
255
+ parts = [
256
+ "dk",
257
+ "run",
258
+ "-d",
259
+ "--name",
260
+ _shq(container),
261
+ "--restart",
262
+ _shq(restart),
263
+ "-p",
264
+ _shq(publish),
265
+ "-v",
266
+ _shq(f"{container}-data:/var/pskit/data"),
267
+ ]
268
+ for item in docker.get("args") or []:
269
+ parts.append(_shq(str(item)))
270
+ parts.append(_shq(image))
271
+ run = " ".join(parts)
272
+ return (
273
+ _docker_shell_header()
274
+ + f"dk load -i {_shq(remote_tar)}\n"
275
+ + f"dk rm -f {_shq(container)} || true\n"
276
+ + run
277
+ + "\n"
278
+ + f"rm -f {_shq(remote_tar)}\n"
279
+ )
149
280
 
150
281
 
151
282
  def dockerfile_text(runtime: str, port: int) -> str:
@@ -208,6 +339,7 @@ def _view(deploy: Dict[str, Any]) -> Any:
208
339
  restart=str(docker.get("restart") or "unless-stopped"),
209
340
  publish=str(docker.get("publish") or ""),
210
341
  docker_args=list(docker.get("args") or []),
342
+ install_docker=bool(docker.get("install_docker", False)),
211
343
  python_url=str(bundle.get("url") or ""),
212
344
  python_sha256=str(bundle.get("sha256") or ""),
213
345
  python_home=str(bundle.get("home") or ""),
@@ -363,7 +495,10 @@ def _run(
363
495
  check: bool = True,
364
496
  ) -> None:
365
497
  fn = run or subprocess.run
366
- proc = fn(list(argv), cwd=str(cwd) if cwd else None, env=env, capture_output=True, text=True)
498
+ try:
499
+ proc = fn(list(argv), cwd=str(cwd) if cwd else None, env=env, capture_output=True, text=True)
500
+ except FileNotFoundError as exc:
501
+ raise DeployError(f"command not found: {argv[0]}. Install it on this machine and retry.") from exc
367
502
  code = int(proc.returncode or 0)
368
503
  if check and code:
369
504
  err = str(proc.stderr or proc.stdout or "")[-4000:]