@marinoscar/platform-cli 0.0.0-stage → 0.1.0-next.10
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.
- package/CHANGELOG.md +149 -0
- package/LICENSE +21 -0
- package/README.md +182 -2
- package/dist/android/build.d.ts +30 -0
- package/dist/android/build.d.ts.map +1 -0
- package/dist/android/build.js +126 -0
- package/dist/android/build.js.map +1 -0
- package/dist/android/command.d.ts +21 -0
- package/dist/android/command.d.ts.map +1 -0
- package/dist/android/command.js +355 -0
- package/dist/android/command.js.map +1 -0
- package/dist/android/deploy-step.d.ts +85 -0
- package/dist/android/deploy-step.d.ts.map +1 -0
- package/dist/android/deploy-step.js +268 -0
- package/dist/android/deploy-step.js.map +1 -0
- package/dist/android/doctor.d.ts +47 -0
- package/dist/android/doctor.d.ts.map +1 -0
- package/dist/android/doctor.js +219 -0
- package/dist/android/doctor.js.map +1 -0
- package/dist/android/exec.d.ts +42 -0
- package/dist/android/exec.d.ts.map +1 -0
- package/dist/android/exec.js +103 -0
- package/dist/android/exec.js.map +1 -0
- package/dist/android/fix-plan.d.ts +44 -0
- package/dist/android/fix-plan.d.ts.map +1 -0
- package/dist/android/fix-plan.js +86 -0
- package/dist/android/fix-plan.js.map +1 -0
- package/dist/android/git-freshness.d.ts +34 -0
- package/dist/android/git-freshness.d.ts.map +1 -0
- package/dist/android/git-freshness.js +120 -0
- package/dist/android/git-freshness.js.map +1 -0
- package/dist/android/gradle.d.ts +32 -0
- package/dist/android/gradle.d.ts.map +1 -0
- package/dist/android/gradle.js +55 -0
- package/dist/android/gradle.js.map +1 -0
- package/dist/android/identity.d.ts +27 -0
- package/dist/android/identity.d.ts.map +1 -0
- package/dist/android/identity.js +60 -0
- package/dist/android/identity.js.map +1 -0
- package/dist/android/index.d.ts +7 -0
- package/dist/android/index.d.ts.map +1 -0
- package/dist/android/index.js +8 -0
- package/dist/android/index.js.map +1 -0
- package/dist/android/installer.d.ts +28 -0
- package/dist/android/installer.d.ts.map +1 -0
- package/dist/android/installer.js +96 -0
- package/dist/android/installer.js.map +1 -0
- package/dist/android/java.d.ts +26 -0
- package/dist/android/java.d.ts.map +1 -0
- package/dist/android/java.js +65 -0
- package/dist/android/java.js.map +1 -0
- package/dist/android/keystore.d.ts +54 -0
- package/dist/android/keystore.d.ts.map +1 -0
- package/dist/android/keystore.js +159 -0
- package/dist/android/keystore.js.map +1 -0
- package/dist/android/metadata.d.ts +39 -0
- package/dist/android/metadata.d.ts.map +1 -0
- package/dist/android/metadata.js +61 -0
- package/dist/android/metadata.js.map +1 -0
- package/dist/android/operations.d.ts +42 -0
- package/dist/android/operations.d.ts.map +1 -0
- package/dist/android/operations.js +59 -0
- package/dist/android/operations.js.map +1 -0
- package/dist/android/paths.d.ts +29 -0
- package/dist/android/paths.d.ts.map +1 -0
- package/dist/android/paths.js +97 -0
- package/dist/android/paths.js.map +1 -0
- package/dist/android/publish.d.ts +37 -0
- package/dist/android/publish.d.ts.map +1 -0
- package/dist/android/publish.js +119 -0
- package/dist/android/publish.js.map +1 -0
- package/dist/android/registrations.d.ts +92 -0
- package/dist/android/registrations.d.ts.map +1 -0
- package/dist/android/registrations.js +112 -0
- package/dist/android/registrations.js.map +1 -0
- package/dist/android/release-status.d.ts +73 -0
- package/dist/android/release-status.d.ts.map +1 -0
- package/dist/android/release-status.js +161 -0
- package/dist/android/release-status.js.map +1 -0
- package/dist/android/release.d.ts +33 -0
- package/dist/android/release.d.ts.map +1 -0
- package/dist/android/release.js +59 -0
- package/dist/android/release.js.map +1 -0
- package/dist/android/screen-layout.d.ts +26 -0
- package/dist/android/screen-layout.d.ts.map +1 -0
- package/dist/android/screen-layout.js +24 -0
- package/dist/android/screen-layout.js.map +1 -0
- package/dist/android/screen-model.d.ts +56 -0
- package/dist/android/screen-model.d.ts.map +1 -0
- package/dist/android/screen-model.js +207 -0
- package/dist/android/screen-model.js.map +1 -0
- package/dist/android/screen.d.ts +8 -0
- package/dist/android/screen.d.ts.map +1 -0
- package/dist/android/screen.js +395 -0
- package/dist/android/screen.js.map +1 -0
- package/dist/android/sdk.d.ts +48 -0
- package/dist/android/sdk.d.ts.map +1 -0
- package/dist/android/sdk.js +82 -0
- package/dist/android/sdk.js.map +1 -0
- package/dist/android/server-url.d.ts +19 -0
- package/dist/android/server-url.d.ts.map +1 -0
- package/dist/android/server-url.js +36 -0
- package/dist/android/server-url.js.map +1 -0
- package/dist/android/upload-progress.d.ts +3 -0
- package/dist/android/upload-progress.d.ts.map +1 -0
- package/dist/android/upload-progress.js +47 -0
- package/dist/android/upload-progress.js.map +1 -0
- package/dist/android/version.d.ts +47 -0
- package/dist/android/version.d.ts.map +1 -0
- package/dist/android/version.js +136 -0
- package/dist/android/version.js.map +1 -0
- package/dist/api-client/index.d.ts +3 -0
- package/dist/api-client/index.d.ts.map +1 -0
- package/dist/api-client/index.js +5 -0
- package/dist/api-client/index.js.map +1 -0
- package/dist/commands/index.d.ts +52 -0
- package/dist/commands/index.d.ts.map +1 -0
- package/dist/commands/index.js +63 -0
- package/dist/commands/index.js.map +1 -0
- package/dist/core/cli-registry.d.ts +41 -0
- package/dist/core/cli-registry.d.ts.map +1 -0
- package/dist/core/cli-registry.js +49 -0
- package/dist/core/cli-registry.js.map +1 -0
- package/dist/core/command-registry.d.ts +60 -0
- package/dist/core/command-registry.d.ts.map +1 -0
- package/dist/core/command-registry.js +114 -0
- package/dist/core/command-registry.js.map +1 -0
- package/dist/core/env-annotation-registry.d.ts +58 -0
- package/dist/core/env-annotation-registry.d.ts.map +1 -0
- package/dist/core/env-annotation-registry.js +80 -0
- package/dist/core/env-annotation-registry.js.map +1 -0
- package/dist/core/env-generator-registry.d.ts +59 -0
- package/dist/core/env-generator-registry.d.ts.map +1 -0
- package/dist/core/env-generator-registry.js +102 -0
- package/dist/core/env-generator-registry.js.map +1 -0
- package/dist/core/env-group-registry.d.ts +65 -0
- package/dist/core/env-group-registry.d.ts.map +1 -0
- package/dist/core/env-group-registry.js +77 -0
- package/dist/core/env-group-registry.js.map +1 -0
- package/dist/core/env-spec-registry.d.ts +133 -0
- package/dist/core/env-spec-registry.d.ts.map +1 -0
- package/dist/core/env-spec-registry.js +103 -0
- package/dist/core/env-spec-registry.js.map +1 -0
- package/dist/core/env-values.d.ts +76 -0
- package/dist/core/env-values.d.ts.map +1 -0
- package/dist/core/env-values.js +125 -0
- package/dist/core/env-values.js.map +1 -0
- package/dist/core/index.d.ts +14 -0
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/index.js +10 -0
- package/dist/core/index.js.map +1 -0
- package/dist/deploy/index.d.ts +3 -0
- package/dist/deploy/index.d.ts.map +1 -0
- package/dist/deploy/index.js +5 -0
- package/dist/deploy/index.js.map +1 -0
- package/dist/engine/api-client.d.ts +211 -0
- package/dist/engine/api-client.d.ts.map +1 -0
- package/dist/engine/api-client.js +350 -0
- package/dist/engine/api-client.js.map +1 -0
- package/dist/engine/browser.d.ts +18 -0
- package/dist/engine/browser.d.ts.map +1 -0
- package/dist/engine/browser.js +115 -0
- package/dist/engine/browser.js.map +1 -0
- package/dist/engine/builtin-registrations.d.ts +20 -0
- package/dist/engine/builtin-registrations.d.ts.map +1 -0
- package/dist/engine/builtin-registrations.js +86 -0
- package/dist/engine/builtin-registrations.js.map +1 -0
- package/dist/engine/commands/api.d.ts +88 -0
- package/dist/engine/commands/api.d.ts.map +1 -0
- package/dist/engine/commands/api.js +398 -0
- package/dist/engine/commands/api.js.map +1 -0
- package/dist/engine/commands/config.d.ts +5 -0
- package/dist/engine/commands/config.d.ts.map +1 -0
- package/dist/engine/commands/config.js +83 -0
- package/dist/engine/commands/config.js.map +1 -0
- package/dist/engine/commands/deploy.d.ts +243 -0
- package/dist/engine/commands/deploy.d.ts.map +1 -0
- package/dist/engine/commands/deploy.js +1164 -0
- package/dist/engine/commands/deploy.js.map +1 -0
- package/dist/engine/commands/init.d.ts +18 -0
- package/dist/engine/commands/init.d.ts.map +1 -0
- package/dist/engine/commands/init.js +50 -0
- package/dist/engine/commands/init.js.map +1 -0
- package/dist/engine/commands/login.d.ts +4 -0
- package/dist/engine/commands/login.d.ts.map +1 -0
- package/dist/engine/commands/login.js +205 -0
- package/dist/engine/commands/login.js.map +1 -0
- package/dist/engine/commands/node.d.ts +21 -0
- package/dist/engine/commands/node.d.ts.map +1 -0
- package/dist/engine/commands/node.js +436 -0
- package/dist/engine/commands/node.js.map +1 -0
- package/dist/engine/config.d.ts +246 -0
- package/dist/engine/config.d.ts.map +1 -0
- package/dist/engine/config.js +414 -0
- package/dist/engine/config.js.map +1 -0
- package/dist/engine/conformance.d.ts +187 -0
- package/dist/engine/conformance.d.ts.map +1 -0
- package/dist/engine/conformance.js +227 -0
- package/dist/engine/conformance.js.map +1 -0
- package/dist/engine/create-cli.d.ts +94 -0
- package/dist/engine/create-cli.d.ts.map +1 -0
- package/dist/engine/create-cli.js +60 -0
- package/dist/engine/create-cli.js.map +1 -0
- package/dist/engine/deploy/about.d.ts +12 -0
- package/dist/engine/deploy/about.d.ts.map +1 -0
- package/dist/engine/deploy/about.js +110 -0
- package/dist/engine/deploy/about.js.map +1 -0
- package/dist/engine/deploy/adopt.d.ts +21 -0
- package/dist/engine/deploy/adopt.d.ts.map +1 -0
- package/dist/engine/deploy/adopt.js +78 -0
- package/dist/engine/deploy/adopt.js.map +1 -0
- package/dist/engine/deploy/answers-file.d.ts +7 -0
- package/dist/engine/deploy/answers-file.d.ts.map +1 -0
- package/dist/engine/deploy/answers-file.js +49 -0
- package/dist/engine/deploy/answers-file.js.map +1 -0
- package/dist/engine/deploy/app-role.d.ts +278 -0
- package/dist/engine/deploy/app-role.d.ts.map +1 -0
- package/dist/engine/deploy/app-role.js +826 -0
- package/dist/engine/deploy/app-role.js.map +1 -0
- package/dist/engine/deploy/app-version.d.ts +47 -0
- package/dist/engine/deploy/app-version.d.ts.map +1 -0
- package/dist/engine/deploy/app-version.js +232 -0
- package/dist/engine/deploy/app-version.js.map +1 -0
- package/dist/engine/deploy/checks/database.d.ts +83 -0
- package/dist/engine/deploy/checks/database.d.ts.map +1 -0
- package/dist/engine/deploy/checks/database.js +455 -0
- package/dist/engine/deploy/checks/database.js.map +1 -0
- package/dist/engine/deploy/checks/dns.d.ts +3 -0
- package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
- package/dist/engine/deploy/checks/dns.js +85 -0
- package/dist/engine/deploy/checks/dns.js.map +1 -0
- package/dist/engine/deploy/checks/host.d.ts +19 -0
- package/dist/engine/deploy/checks/host.d.ts.map +1 -0
- package/dist/engine/deploy/checks/host.js +530 -0
- package/dist/engine/deploy/checks/host.js.map +1 -0
- package/dist/engine/deploy/checks/index.d.ts +33 -0
- package/dist/engine/deploy/checks/index.d.ts.map +1 -0
- package/dist/engine/deploy/checks/index.js +67 -0
- package/dist/engine/deploy/checks/index.js.map +1 -0
- package/dist/engine/deploy/checks/registry.d.ts +102 -0
- package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
- package/dist/engine/deploy/checks/registry.js +103 -0
- package/dist/engine/deploy/checks/registry.js.map +1 -0
- package/dist/engine/deploy/checks/source.d.ts +45 -0
- package/dist/engine/deploy/checks/source.d.ts.map +1 -0
- package/dist/engine/deploy/checks/source.js +175 -0
- package/dist/engine/deploy/checks/source.js.map +1 -0
- package/dist/engine/deploy/checks/tls.d.ts +87 -0
- package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
- package/dist/engine/deploy/checks/tls.js +552 -0
- package/dist/engine/deploy/checks/tls.js.map +1 -0
- package/dist/engine/deploy/checks/types.d.ts +178 -0
- package/dist/engine/deploy/checks/types.d.ts.map +1 -0
- package/dist/engine/deploy/checks/types.js +199 -0
- package/dist/engine/deploy/checks/types.js.map +1 -0
- package/dist/engine/deploy/compose-files.d.ts +29 -0
- package/dist/engine/deploy/compose-files.d.ts.map +1 -0
- package/dist/engine/deploy/compose-files.js +118 -0
- package/dist/engine/deploy/compose-files.js.map +1 -0
- package/dist/engine/deploy/compose-hints.d.ts +11 -0
- package/dist/engine/deploy/compose-hints.d.ts.map +1 -0
- package/dist/engine/deploy/compose-hints.js +70 -0
- package/dist/engine/deploy/compose-hints.js.map +1 -0
- package/dist/engine/deploy/consent.d.ts +29 -0
- package/dist/engine/deploy/consent.d.ts.map +1 -0
- package/dist/engine/deploy/consent.js +35 -0
- package/dist/engine/deploy/consent.js.map +1 -0
- package/dist/engine/deploy/database-drop.d.ts +22 -0
- package/dist/engine/deploy/database-drop.d.ts.map +1 -0
- package/dist/engine/deploy/database-drop.js +135 -0
- package/dist/engine/deploy/database-drop.js.map +1 -0
- package/dist/engine/deploy/database.d.ts +116 -0
- package/dist/engine/deploy/database.d.ts.map +1 -0
- package/dist/engine/deploy/database.js +252 -0
- package/dist/engine/deploy/database.js.map +1 -0
- package/dist/engine/deploy/deploy-info.d.ts +48 -0
- package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
- package/dist/engine/deploy/deploy-info.js +163 -0
- package/dist/engine/deploy/deploy-info.js.map +1 -0
- package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
- package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
- package/dist/engine/deploy/deployment-evidence.js +92 -0
- package/dist/engine/deploy/deployment-evidence.js.map +1 -0
- package/dist/engine/deploy/edge-config.d.ts +103 -0
- package/dist/engine/deploy/edge-config.d.ts.map +1 -0
- package/dist/engine/deploy/edge-config.js +170 -0
- package/dist/engine/deploy/edge-config.js.map +1 -0
- package/dist/engine/deploy/env-absence.d.ts +61 -0
- package/dist/engine/deploy/env-absence.d.ts.map +1 -0
- package/dist/engine/deploy/env-absence.js +33 -0
- package/dist/engine/deploy/env-absence.js.map +1 -0
- package/dist/engine/deploy/env-file.d.ts +14 -0
- package/dist/engine/deploy/env-file.d.ts.map +1 -0
- package/dist/engine/deploy/env-file.js +58 -0
- package/dist/engine/deploy/env-file.js.map +1 -0
- package/dist/engine/deploy/env-fragments.d.ts +29 -0
- package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
- package/dist/engine/deploy/env-fragments.js +73 -0
- package/dist/engine/deploy/env-fragments.js.map +1 -0
- package/dist/engine/deploy/env-metadata.d.ts +73 -0
- package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
- package/dist/engine/deploy/env-metadata.js +227 -0
- package/dist/engine/deploy/env-metadata.js.map +1 -0
- package/dist/engine/deploy/env-spec.d.ts +75 -0
- package/dist/engine/deploy/env-spec.d.ts.map +1 -0
- package/dist/engine/deploy/env-spec.js +239 -0
- package/dist/engine/deploy/env-spec.js.map +1 -0
- package/dist/engine/deploy/env-wizard.d.ts +56 -0
- package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
- package/dist/engine/deploy/env-wizard.js +235 -0
- package/dist/engine/deploy/env-wizard.js.map +1 -0
- package/dist/engine/deploy/executor.d.ts +81 -0
- package/dist/engine/deploy/executor.d.ts.map +1 -0
- package/dist/engine/deploy/executor.js +247 -0
- package/dist/engine/deploy/executor.js.map +1 -0
- package/dist/engine/deploy/health.d.ts +153 -0
- package/dist/engine/deploy/health.d.ts.map +1 -0
- package/dist/engine/deploy/health.js +335 -0
- package/dist/engine/deploy/health.js.map +1 -0
- package/dist/engine/deploy/hooks.d.ts +66 -0
- package/dist/engine/deploy/hooks.d.ts.map +1 -0
- package/dist/engine/deploy/hooks.js +19 -0
- package/dist/engine/deploy/hooks.js.map +1 -0
- package/dist/engine/deploy/host-facts.d.ts +23 -0
- package/dist/engine/deploy/host-facts.d.ts.map +1 -0
- package/dist/engine/deploy/host-facts.js +67 -0
- package/dist/engine/deploy/host-facts.js.map +1 -0
- package/dist/engine/deploy/install.d.ts +233 -0
- package/dist/engine/deploy/install.d.ts.map +1 -0
- package/dist/engine/deploy/install.js +1315 -0
- package/dist/engine/deploy/install.js.map +1 -0
- package/dist/engine/deploy/inventory.d.ts +30 -0
- package/dist/engine/deploy/inventory.d.ts.map +1 -0
- package/dist/engine/deploy/inventory.js +122 -0
- package/dist/engine/deploy/inventory.js.map +1 -0
- package/dist/engine/deploy/journal.d.ts +77 -0
- package/dist/engine/deploy/journal.d.ts.map +1 -0
- package/dist/engine/deploy/journal.js +221 -0
- package/dist/engine/deploy/journal.js.map +1 -0
- package/dist/engine/deploy/layout.d.ts +77 -0
- package/dist/engine/deploy/layout.d.ts.map +1 -0
- package/dist/engine/deploy/layout.js +191 -0
- package/dist/engine/deploy/layout.js.map +1 -0
- package/dist/engine/deploy/oauth-check.d.ts +58 -0
- package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
- package/dist/engine/deploy/oauth-check.js +213 -0
- package/dist/engine/deploy/oauth-check.js.map +1 -0
- package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
- package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
- package/dist/engine/deploy/proxy-bootstrap.js +416 -0
- package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
- package/dist/engine/deploy/proxy-streams.d.ts +110 -0
- package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
- package/dist/engine/deploy/proxy-streams.js +208 -0
- package/dist/engine/deploy/proxy-streams.js.map +1 -0
- package/dist/engine/deploy/proxy.d.ts +375 -0
- package/dist/engine/deploy/proxy.d.ts.map +1 -0
- package/dist/engine/deploy/proxy.js +758 -0
- package/dist/engine/deploy/proxy.js.map +1 -0
- package/dist/engine/deploy/renewal.d.ts +54 -0
- package/dist/engine/deploy/renewal.d.ts.map +1 -0
- package/dist/engine/deploy/renewal.js +169 -0
- package/dist/engine/deploy/renewal.js.map +1 -0
- package/dist/engine/deploy/repo.d.ts +119 -0
- package/dist/engine/deploy/repo.d.ts.map +1 -0
- package/dist/engine/deploy/repo.js +277 -0
- package/dist/engine/deploy/repo.js.map +1 -0
- package/dist/engine/deploy/run-record.d.ts +28 -0
- package/dist/engine/deploy/run-record.d.ts.map +1 -0
- package/dist/engine/deploy/run-record.js +44 -0
- package/dist/engine/deploy/run-record.js.map +1 -0
- package/dist/engine/deploy/state.d.ts +289 -0
- package/dist/engine/deploy/state.d.ts.map +1 -0
- package/dist/engine/deploy/state.js +163 -0
- package/dist/engine/deploy/state.js.map +1 -0
- package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
- package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
- package/dist/engine/deploy/steps/app-step-context.js +45 -0
- package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
- package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
- package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
- package/dist/engine/deploy/steps/pipeline.js +73 -0
- package/dist/engine/deploy/steps/pipeline.js.map +1 -0
- package/dist/engine/deploy/steps/plan.d.ts +28 -0
- package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
- package/dist/engine/deploy/steps/plan.js +32 -0
- package/dist/engine/deploy/steps/plan.js.map +1 -0
- package/dist/engine/deploy/steps/registry.d.ts +182 -0
- package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
- package/dist/engine/deploy/steps/registry.js +212 -0
- package/dist/engine/deploy/steps/registry.js.map +1 -0
- package/dist/engine/deploy/steps/step-values.d.ts +28 -0
- package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
- package/dist/engine/deploy/steps/step-values.js +33 -0
- package/dist/engine/deploy/steps/step-values.js.map +1 -0
- package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
- package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
- package/dist/engine/deploy/testing/fake-postgres.js +236 -0
- package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
- package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
- package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
- package/dist/engine/deploy/testing/fake-vps.js +365 -0
- package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
- package/dist/engine/deploy/uninstall.d.ts +87 -0
- package/dist/engine/deploy/uninstall.d.ts.map +1 -0
- package/dist/engine/deploy/uninstall.js +321 -0
- package/dist/engine/deploy/uninstall.js.map +1 -0
- package/dist/engine/deploy/update.d.ts +112 -0
- package/dist/engine/deploy/update.d.ts.map +1 -0
- package/dist/engine/deploy/update.js +1279 -0
- package/dist/engine/deploy/update.js.map +1 -0
- package/dist/engine/deploy/version-step.d.ts +65 -0
- package/dist/engine/deploy/version-step.d.ts.map +1 -0
- package/dist/engine/deploy/version-step.js +176 -0
- package/dist/engine/deploy/version-step.js.map +1 -0
- package/dist/engine/device-auth.d.ts +240 -0
- package/dist/engine/device-auth.d.ts.map +1 -0
- package/dist/engine/device-auth.js +442 -0
- package/dist/engine/device-auth.js.map +1 -0
- package/dist/engine/device-login.d.ts +126 -0
- package/dist/engine/device-login.d.ts.map +1 -0
- package/dist/engine/device-login.js +164 -0
- package/dist/engine/device-login.js.map +1 -0
- package/dist/engine/errors.d.ts +314 -0
- package/dist/engine/errors.d.ts.map +1 -0
- package/dist/engine/errors.js +561 -0
- package/dist/engine/errors.js.map +1 -0
- package/dist/engine/identity.d.ts +169 -0
- package/dist/engine/identity.d.ts.map +1 -0
- package/dist/engine/identity.js +227 -0
- package/dist/engine/identity.js.map +1 -0
- package/dist/engine/index.d.ts +104 -0
- package/dist/engine/index.d.ts.map +1 -0
- package/dist/engine/index.js +126 -0
- package/dist/engine/index.js.map +1 -0
- package/dist/engine/init/local-profile.d.ts +93 -0
- package/dist/engine/init/local-profile.d.ts.map +1 -0
- package/dist/engine/init/local-profile.js +295 -0
- package/dist/engine/init/local-profile.js.map +1 -0
- package/dist/engine/init/run-init.d.ts +41 -0
- package/dist/engine/init/run-init.d.ts.map +1 -0
- package/dist/engine/init/run-init.js +297 -0
- package/dist/engine/init/run-init.js.map +1 -0
- package/dist/engine/node/capabilities.d.ts +238 -0
- package/dist/engine/node/capabilities.d.ts.map +1 -0
- package/dist/engine/node/capabilities.js +316 -0
- package/dist/engine/node/capabilities.js.map +1 -0
- package/dist/engine/node/daemon.d.ts +63 -0
- package/dist/engine/node/daemon.d.ts.map +1 -0
- package/dist/engine/node/daemon.js +227 -0
- package/dist/engine/node/daemon.js.map +1 -0
- package/dist/engine/node/doctor.d.ts +58 -0
- package/dist/engine/node/doctor.d.ts.map +1 -0
- package/dist/engine/node/doctor.js +394 -0
- package/dist/engine/node/doctor.js.map +1 -0
- package/dist/engine/node/enrollment.d.ts +98 -0
- package/dist/engine/node/enrollment.d.ts.map +1 -0
- package/dist/engine/node/enrollment.js +189 -0
- package/dist/engine/node/enrollment.js.map +1 -0
- package/dist/engine/node/env-flags.d.ts +5 -0
- package/dist/engine/node/env-flags.d.ts.map +1 -0
- package/dist/engine/node/env-flags.js +22 -0
- package/dist/engine/node/env-flags.js.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.js +189 -0
- package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
- package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
- package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
- package/dist/engine/node/executors/db-backup-run.js +362 -0
- package/dist/engine/node/executors/db-backup-run.js.map +1 -0
- package/dist/engine/node/executors/example-checksum.d.ts +30 -0
- package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
- package/dist/engine/node/executors/example-checksum.js +56 -0
- package/dist/engine/node/executors/example-checksum.js.map +1 -0
- package/dist/engine/node/executors/index.d.ts +168 -0
- package/dist/engine/node/executors/index.d.ts.map +1 -0
- package/dist/engine/node/executors/index.js +44 -0
- package/dist/engine/node/executors/index.js.map +1 -0
- package/dist/engine/node/executors/registry.d.ts +38 -0
- package/dist/engine/node/executors/registry.d.ts.map +1 -0
- package/dist/engine/node/executors/registry.js +92 -0
- package/dist/engine/node/executors/registry.js.map +1 -0
- package/dist/engine/node/heap-snapshot.d.ts +37 -0
- package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
- package/dist/engine/node/heap-snapshot.js +160 -0
- package/dist/engine/node/heap-snapshot.js.map +1 -0
- package/dist/engine/node/install-deps.d.ts +73 -0
- package/dist/engine/node/install-deps.d.ts.map +1 -0
- package/dist/engine/node/install-deps.js +150 -0
- package/dist/engine/node/install-deps.js.map +1 -0
- package/dist/engine/node/ipc-protocol.d.ts +67 -0
- package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
- package/dist/engine/node/ipc-protocol.js +83 -0
- package/dist/engine/node/ipc-protocol.js.map +1 -0
- package/dist/engine/node/lifecycle.d.ts +103 -0
- package/dist/engine/node/lifecycle.d.ts.map +1 -0
- package/dist/engine/node/lifecycle.js +259 -0
- package/dist/engine/node/lifecycle.js.map +1 -0
- package/dist/engine/node/logger.d.ts +82 -0
- package/dist/engine/node/logger.d.ts.map +1 -0
- package/dist/engine/node/logger.js +241 -0
- package/dist/engine/node/logger.js.map +1 -0
- package/dist/engine/node/memory-watchdog.d.ts +78 -0
- package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
- package/dist/engine/node/memory-watchdog.js +224 -0
- package/dist/engine/node/memory-watchdog.js.map +1 -0
- package/dist/engine/node/node-api.d.ts +391 -0
- package/dist/engine/node/node-api.d.ts.map +1 -0
- package/dist/engine/node/node-api.js +123 -0
- package/dist/engine/node/node-api.js.map +1 -0
- package/dist/engine/node/node-config.d.ts +128 -0
- package/dist/engine/node/node-config.d.ts.map +1 -0
- package/dist/engine/node/node-config.js +237 -0
- package/dist/engine/node/node-config.js.map +1 -0
- package/dist/engine/node/node-dashboard-source.d.ts +56 -0
- package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
- package/dist/engine/node/node-dashboard-source.js +213 -0
- package/dist/engine/node/node-dashboard-source.js.map +1 -0
- package/dist/engine/node/node-engine.d.ts +229 -0
- package/dist/engine/node/node-engine.d.ts.map +1 -0
- package/dist/engine/node/node-engine.js +723 -0
- package/dist/engine/node/node-engine.js.map +1 -0
- package/dist/engine/node/node-errors.d.ts +54 -0
- package/dist/engine/node/node-errors.d.ts.map +1 -0
- package/dist/engine/node/node-errors.js +71 -0
- package/dist/engine/node/node-errors.js.map +1 -0
- package/dist/engine/node/node-events.d.ts +132 -0
- package/dist/engine/node/node-events.d.ts.map +1 -0
- package/dist/engine/node/node-events.js +2 -0
- package/dist/engine/node/node-events.js.map +1 -0
- package/dist/engine/node/node-vitals.d.ts +123 -0
- package/dist/engine/node/node-vitals.d.ts.map +1 -0
- package/dist/engine/node/node-vitals.js +266 -0
- package/dist/engine/node/node-vitals.js.map +1 -0
- package/dist/engine/node/paths.d.ts +39 -0
- package/dist/engine/node/paths.d.ts.map +1 -0
- package/dist/engine/node/paths.js +60 -0
- package/dist/engine/node/paths.js.map +1 -0
- package/dist/engine/node/pg-dump.d.ts +126 -0
- package/dist/engine/node/pg-dump.d.ts.map +1 -0
- package/dist/engine/node/pg-dump.js +223 -0
- package/dist/engine/node/pg-dump.js.map +1 -0
- package/dist/engine/node/pidfile.d.ts +38 -0
- package/dist/engine/node/pidfile.d.ts.map +1 -0
- package/dist/engine/node/pidfile.js +156 -0
- package/dist/engine/node/pidfile.js.map +1 -0
- package/dist/engine/node/runtime-tuning.d.ts +65 -0
- package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
- package/dist/engine/node/runtime-tuning.js +198 -0
- package/dist/engine/node/runtime-tuning.js.map +1 -0
- package/dist/engine/node/service.d.ts +39 -0
- package/dist/engine/node/service.d.ts.map +1 -0
- package/dist/engine/node/service.js +211 -0
- package/dist/engine/node/service.js.map +1 -0
- package/dist/engine/node/start.d.ts +62 -0
- package/dist/engine/node/start.d.ts.map +1 -0
- package/dist/engine/node/start.js +245 -0
- package/dist/engine/node/start.js.map +1 -0
- package/dist/engine/node/worker-env-table.d.ts +15 -0
- package/dist/engine/node/worker-env-table.d.ts.map +1 -0
- package/dist/engine/node/worker-env-table.js +97 -0
- package/dist/engine/node/worker-env-table.js.map +1 -0
- package/dist/engine/node/worker-env.d.ts +50 -0
- package/dist/engine/node/worker-env.d.ts.map +1 -0
- package/dist/engine/node/worker-env.js +101 -0
- package/dist/engine/node/worker-env.js.map +1 -0
- package/dist/engine/output.d.ts +97 -0
- package/dist/engine/output.d.ts.map +1 -0
- package/dist/engine/output.js +274 -0
- package/dist/engine/output.js.map +1 -0
- package/dist/engine/package-info.d.ts +7 -0
- package/dist/engine/package-info.d.ts.map +1 -0
- package/dist/engine/package-info.js +38 -0
- package/dist/engine/package-info.js.map +1 -0
- package/dist/engine/program.d.ts +50 -0
- package/dist/engine/program.d.ts.map +1 -0
- package/dist/engine/program.js +197 -0
- package/dist/engine/program.js.map +1 -0
- package/dist/engine/prompt.d.ts +69 -0
- package/dist/engine/prompt.d.ts.map +1 -0
- package/dist/engine/prompt.js +205 -0
- package/dist/engine/prompt.js.map +1 -0
- package/dist/engine/registries.d.ts +5 -0
- package/dist/engine/registries.d.ts.map +1 -0
- package/dist/engine/registries.js +52 -0
- package/dist/engine/registries.js.map +1 -0
- package/dist/engine/request-body.d.ts +31 -0
- package/dist/engine/request-body.d.ts.map +1 -0
- package/dist/engine/request-body.js +156 -0
- package/dist/engine/request-body.js.map +1 -0
- package/dist/engine/test-support.d.ts +50 -0
- package/dist/engine/test-support.d.ts.map +1 -0
- package/dist/engine/test-support.js +86 -0
- package/dist/engine/test-support.js.map +1 -0
- package/dist/engine/tui/app.d.ts +3 -0
- package/dist/engine/tui/app.d.ts.map +1 -0
- package/dist/engine/tui/app.js +100 -0
- package/dist/engine/tui/app.js.map +1 -0
- package/dist/engine/tui/builtin-screens.d.ts +6 -0
- package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
- package/dist/engine/tui/builtin-screens.js +54 -0
- package/dist/engine/tui/builtin-screens.js.map +1 -0
- package/dist/engine/tui/index.d.ts +23 -0
- package/dist/engine/tui/index.d.ts.map +1 -0
- package/dist/engine/tui/index.js +71 -0
- package/dist/engine/tui/index.js.map +1 -0
- package/dist/engine/tui/layout.d.ts +132 -0
- package/dist/engine/tui/layout.d.ts.map +1 -0
- package/dist/engine/tui/layout.js +200 -0
- package/dist/engine/tui/layout.js.map +1 -0
- package/dist/engine/tui/routes.d.ts +5 -0
- package/dist/engine/tui/routes.d.ts.map +1 -0
- package/dist/engine/tui/routes.js +16 -0
- package/dist/engine/tui/routes.js.map +1 -0
- package/dist/engine/tui/screen-registry.d.ts +100 -0
- package/dist/engine/tui/screen-registry.d.ts.map +1 -0
- package/dist/engine/tui/screen-registry.js +96 -0
- package/dist/engine/tui/screen-registry.js.map +1 -0
- package/dist/engine/tui/screen-sections.d.ts +9 -0
- package/dist/engine/tui/screen-sections.d.ts.map +1 -0
- package/dist/engine/tui/screen-sections.js +45 -0
- package/dist/engine/tui/screen-sections.js.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.js +153 -0
- package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.js +202 -0
- package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
- package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
- package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/index.js +83 -0
- package/dist/engine/tui/screens/deploy/index.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.js +319 -0
- package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install.js +361 -0
- package/dist/engine/tui/screens/deploy/install.js.map +1 -0
- package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
- package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/model.js +59 -0
- package/dist/engine/tui/screens/deploy/model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.js +117 -0
- package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
- package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run.js +201 -0
- package/dist/engine/tui/screens/deploy/run.js.map +1 -0
- package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
- package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/status.js +107 -0
- package/dist/engine/tui/screens/deploy/status.js.map +1 -0
- package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
- package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/update.js +175 -0
- package/dist/engine/tui/screens/deploy/update.js.map +1 -0
- package/dist/engine/tui/screens/deploy.d.ts +12 -0
- package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy.js +23 -0
- package/dist/engine/tui/screens/deploy.js.map +1 -0
- package/dist/engine/tui/screens/invoke.d.ts +6 -0
- package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
- package/dist/engine/tui/screens/invoke.js +193 -0
- package/dist/engine/tui/screens/invoke.js.map +1 -0
- package/dist/engine/tui/screens/login.d.ts +6 -0
- package/dist/engine/tui/screens/login.d.ts.map +1 -0
- package/dist/engine/tui/screens/login.js +255 -0
- package/dist/engine/tui/screens/login.js.map +1 -0
- package/dist/engine/tui/screens/logout.d.ts +6 -0
- package/dist/engine/tui/screens/logout.d.ts.map +1 -0
- package/dist/engine/tui/screens/logout.js +142 -0
- package/dist/engine/tui/screens/logout.js.map +1 -0
- package/dist/engine/tui/screens/menu.d.ts +22 -0
- package/dist/engine/tui/screens/menu.d.ts.map +1 -0
- package/dist/engine/tui/screens/menu.js +84 -0
- package/dist/engine/tui/screens/menu.js.map +1 -0
- package/dist/engine/tui/screens/node.d.ts +6 -0
- package/dist/engine/tui/screens/node.d.ts.map +1 -0
- package/dist/engine/tui/screens/node.js +228 -0
- package/dist/engine/tui/screens/node.js.map +1 -0
- package/dist/engine/tui/screens/status.d.ts +6 -0
- package/dist/engine/tui/screens/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/status.js +134 -0
- package/dist/engine/tui/screens/status.js.map +1 -0
- package/dist/engine/tui/scroll-box.d.ts +27 -0
- package/dist/engine/tui/scroll-box.d.ts.map +1 -0
- package/dist/engine/tui/scroll-box.js +52 -0
- package/dist/engine/tui/scroll-box.js.map +1 -0
- package/dist/engine/tui/section-registry.d.ts +65 -0
- package/dist/engine/tui/section-registry.d.ts.map +1 -0
- package/dist/engine/tui/section-registry.js +90 -0
- package/dist/engine/tui/section-registry.js.map +1 -0
- package/dist/engine/tui/terminal.d.ts +31 -0
- package/dist/engine/tui/terminal.d.ts.map +1 -0
- package/dist/engine/tui/terminal.js +142 -0
- package/dist/engine/tui/terminal.js.map +1 -0
- package/dist/engine/tui/tty.d.ts +49 -0
- package/dist/engine/tui/tty.d.ts.map +1 -0
- package/dist/engine/tui/tty.js +139 -0
- package/dist/engine/tui/tty.js.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -0
- package/dist/node/index.d.ts +3 -0
- package/dist/node/index.d.ts.map +1 -0
- package/dist/node/index.js +5 -0
- package/dist/node/index.js.map +1 -0
- package/dist/telemetry/env-fragment.d.ts +47 -0
- package/dist/telemetry/env-fragment.d.ts.map +1 -0
- package/dist/telemetry/env-fragment.js +73 -0
- package/dist/telemetry/env-fragment.js.map +1 -0
- package/dist/telemetry/index.d.ts +7 -0
- package/dist/telemetry/index.d.ts.map +1 -0
- package/dist/telemetry/index.js +7 -0
- package/dist/telemetry/index.js.map +1 -0
- package/dist/telemetry/node-span-relay.d.ts +107 -0
- package/dist/telemetry/node-span-relay.d.ts.map +1 -0
- package/dist/telemetry/node-span-relay.js +314 -0
- package/dist/telemetry/node-span-relay.js.map +1 -0
- package/dist/telemetry/node-span.d.ts +92 -0
- package/dist/telemetry/node-span.d.ts.map +1 -0
- package/dist/telemetry/node-span.js +28 -0
- package/dist/telemetry/node-span.js.map +1 -0
- package/dist/testing/index.d.ts +3 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +4 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/tui/index.d.ts +3 -0
- package/dist/tui/index.d.ts.map +1 -0
- package/dist/tui/index.js +5 -0
- package/dist/tui/index.js.map +1 -0
- package/package.json +102 -4
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
import type { runCommand } from '../executor.js';
|
|
2
|
+
import type { ProxyRuntime } from '../proxy.js';
|
|
3
|
+
export type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
|
|
4
|
+
export interface CheckResult {
|
|
5
|
+
status: CheckStatus;
|
|
6
|
+
/** One line: what was found. "Docker 27.3.1", or "not installed". */
|
|
7
|
+
detail: string;
|
|
8
|
+
/** Shown on warn/fail. A command or a path, never a category. */
|
|
9
|
+
remedy?: string | undefined;
|
|
10
|
+
}
|
|
11
|
+
/** Filesystem probes, injectable so checks are testable without a real server. */
|
|
12
|
+
export interface CheckFs {
|
|
13
|
+
exists(path: string): boolean;
|
|
14
|
+
isDirectory(path: string): boolean;
|
|
15
|
+
isWritable(path: string): boolean;
|
|
16
|
+
/** UTF-8 contents, or undefined when absent or unreadable. Never throws. */
|
|
17
|
+
readFile(path: string): string | undefined;
|
|
18
|
+
/** Entry names, or [] when absent or unreadable. Never throws. */
|
|
19
|
+
readdir(path: string): string[];
|
|
20
|
+
}
|
|
21
|
+
export declare const realFs: CheckFs;
|
|
22
|
+
/** What the certificate ON THE WIRE says, as opposed to the one on disk. */
|
|
23
|
+
export interface ServedCertificate {
|
|
24
|
+
/** The peer certificate's `valid_to`. */
|
|
25
|
+
notAfter: Date;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Reads the certificate a TLS server presents for `domain`.
|
|
29
|
+
*
|
|
30
|
+
* `rejectUnauthorized: false` because the question is WHICH certificate is
|
|
31
|
+
* served, not whether it is trusted -- an expired or staging certificate is
|
|
32
|
+
* exactly the one this has to be able to read. Nothing is sent after the
|
|
33
|
+
* handshake. Rejects on any failure; the caller decides what that means.
|
|
34
|
+
*/
|
|
35
|
+
export declare function fetchServedCertificate(domain: string, options?: {
|
|
36
|
+
port?: number;
|
|
37
|
+
timeoutMs?: number;
|
|
38
|
+
}): Promise<ServedCertificate>;
|
|
39
|
+
/**
|
|
40
|
+
* True when nothing is listening on the loopback address for `port`.
|
|
41
|
+
*
|
|
42
|
+
* Binding is used rather than parsing `ss` output: it needs no external tool,
|
|
43
|
+
* it cannot be confused by a different output format, and it answers the
|
|
44
|
+
* question that actually matters - can this deployment take the port.
|
|
45
|
+
*/
|
|
46
|
+
export declare function isLoopbackPortFree(port: number): Promise<boolean>;
|
|
47
|
+
/** True when something answers on `port` of any interface. */
|
|
48
|
+
export declare function isPortListening(port: number): Promise<boolean>;
|
|
49
|
+
export interface CheckContext {
|
|
50
|
+
runCommand: typeof runCommand;
|
|
51
|
+
/** Where the deployment lives, or will. */
|
|
52
|
+
deployRoot: string;
|
|
53
|
+
/** Loopback port the shared proxy forwards to. */
|
|
54
|
+
bindPort: number;
|
|
55
|
+
/** The shared reverse proxy's directory. */
|
|
56
|
+
proxyRoot: string;
|
|
57
|
+
/** Public hostname, when one is known. DNS and TLS checks need it. */
|
|
58
|
+
domain?: string | undefined;
|
|
59
|
+
/** The resolved environment, when one exists. Database checks need it. */
|
|
60
|
+
env?: ReadonlyMap<string, string> | undefined;
|
|
61
|
+
fs?: CheckFs | undefined;
|
|
62
|
+
totalMemoryBytes?: (() => number) | undefined;
|
|
63
|
+
portFree?: ((port: number) => Promise<boolean>) | undefined;
|
|
64
|
+
portListening?: ((port: number) => Promise<boolean>) | undefined;
|
|
65
|
+
/** Resolves DNS; injected so the DNS checks (#177) are testable. */
|
|
66
|
+
resolveHost?: ((hostname: string) => Promise<string[]>) | undefined;
|
|
67
|
+
/** This host's own public addresses, when they can be determined. */
|
|
68
|
+
ownAddresses?: (() => Promise<string[]>) | undefined;
|
|
69
|
+
/**
|
|
70
|
+
* How the shared proxy runs, resolved once by the command building this
|
|
71
|
+
* context (see `resolveProxyRuntime`). Absent means unknown, and the checks
|
|
72
|
+
* that care fall back to their historical host-mode behaviour.
|
|
73
|
+
*/
|
|
74
|
+
proxyRuntime?: ProxyRuntime | undefined;
|
|
75
|
+
/** Reads the certificate served on the wire; injected so no test opens a socket. */
|
|
76
|
+
servedCertificate?: ((domain: string) => Promise<ServedCertificate>) | undefined;
|
|
77
|
+
/**
|
|
78
|
+
* The repository this deployment clones or fetches, when it is known (a
|
|
79
|
+
* flag, the deployment record, or the checkout's `origin`). Display-safe:
|
|
80
|
+
* normalised, so it carries no embedded credential.
|
|
81
|
+
*/
|
|
82
|
+
repoUrl?: string | undefined;
|
|
83
|
+
/**
|
|
84
|
+
* Whether git can ALREADY read `repoUrl` without a prompt -- a public
|
|
85
|
+
* repository, a credential helper, a stored token. Computed ONCE by the
|
|
86
|
+
* command building this context (see `gitCredentialStateFor`), because
|
|
87
|
+
* `severityFor` must stay synchronous and cheap. Absent means "not probed":
|
|
88
|
+
* nothing is promoted on an unknown.
|
|
89
|
+
*/
|
|
90
|
+
gitCredentialed?: boolean | undefined;
|
|
91
|
+
/**
|
|
92
|
+
* True when this run will NOT publish through the shared proxy (install or
|
|
93
|
+
* update with --skip-proxy). The proxy prerequisites are then advice, not
|
|
94
|
+
* blockers. Doctor leaves it unset: it asks about a deployment in general.
|
|
95
|
+
*/
|
|
96
|
+
skipProxy?: boolean | undefined;
|
|
97
|
+
/**
|
|
98
|
+
* True when this run is authorised to BOOTSTRAP the shared proxy if it is
|
|
99
|
+
* absent (#391: `--bootstrap-proxy`, or a yes at install's prompt). A proxy
|
|
100
|
+
* container that does not exist, in a proxy root with no compose file, is
|
|
101
|
+
* then not a blocker -- install is about to create it. An existing but
|
|
102
|
+
* stopped proxy, or a root with a compose file, still fails: those belong to
|
|
103
|
+
* somebody else and are never touched.
|
|
104
|
+
*/
|
|
105
|
+
proxyBootstrap?: boolean | undefined;
|
|
106
|
+
/**
|
|
107
|
+
* True when the operator chose to run the API as a superuser or BYPASSRLS
|
|
108
|
+
* role anyway (`--allow-superuser`, recorded in the deployment state, #980).
|
|
109
|
+
* `database-role-ordinary` then reports a warning that names the consequence
|
|
110
|
+
* instead of failing.
|
|
111
|
+
*/
|
|
112
|
+
allowSuperuser?: boolean | undefined;
|
|
113
|
+
}
|
|
114
|
+
export type Severity = 'required' | 'recommended';
|
|
115
|
+
export interface Check {
|
|
116
|
+
/** Stable, kebab-case. Used by --json and by tests. */
|
|
117
|
+
id: string;
|
|
118
|
+
title: string;
|
|
119
|
+
/**
|
|
120
|
+
* The static severity: what the check is when nothing about the context
|
|
121
|
+
* says otherwise. Read it through `severityOf`, never directly, once a
|
|
122
|
+
* context exists.
|
|
123
|
+
*/
|
|
124
|
+
severity: Severity;
|
|
125
|
+
/**
|
|
126
|
+
* The severity for THIS context, when it depends on one -- `certbot-installed`
|
|
127
|
+
* is required only when the proxy runs on the host. Must be read-only and
|
|
128
|
+
* cheap; a throw falls back to `severity`.
|
|
129
|
+
*/
|
|
130
|
+
severityFor?: ((context: CheckContext) => Severity) | undefined;
|
|
131
|
+
/** Ids that must pass first; otherwise this reports `skip`. */
|
|
132
|
+
requires?: readonly string[] | undefined;
|
|
133
|
+
run(context: CheckContext): Promise<CheckResult>;
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* A check's EFFECTIVE severity in a context.
|
|
137
|
+
*
|
|
138
|
+
* ⚠ Everything that decides an exit code -- `requiredChecks`, `checksPassed`
|
|
139
|
+
* via `CompletedCheck.severity`, the doctor and preflight renderers -- goes
|
|
140
|
+
* through this, so a check promoted or demoted by its context is promoted or
|
|
141
|
+
* demoted everywhere at once rather than in whichever caller remembered.
|
|
142
|
+
*/
|
|
143
|
+
export declare function severityOf(check: Check, context: CheckContext): Severity;
|
|
144
|
+
export interface CompletedCheck extends CheckResult {
|
|
145
|
+
id: string;
|
|
146
|
+
title: string;
|
|
147
|
+
/** The EFFECTIVE severity this run evaluated it under -- see `severityOf`. */
|
|
148
|
+
severity: Severity;
|
|
149
|
+
durationMs: number;
|
|
150
|
+
}
|
|
151
|
+
export declare function contextFs(context: CheckContext): CheckFs;
|
|
152
|
+
export declare function contextMemory(context: CheckContext): number;
|
|
153
|
+
export declare function contextPortFree(context: CheckContext): (port: number) => Promise<boolean>;
|
|
154
|
+
export declare function contextServedCertificate(context: CheckContext): (domain: string) => Promise<ServedCertificate>;
|
|
155
|
+
export declare function contextPortListening(context: CheckContext): (port: number) => Promise<boolean>;
|
|
156
|
+
/**
|
|
157
|
+
* Runs the registry in order, honouring `requires`.
|
|
158
|
+
*
|
|
159
|
+
* A check that throws is reported as a failure and the run continues - rule 1.
|
|
160
|
+
* `onResult` fires as each completes so a command can stream a checklist
|
|
161
|
+
* rather than appearing to hang through a dozen subprocess calls.
|
|
162
|
+
*/
|
|
163
|
+
export declare function runChecks(checks: readonly Check[], context: CheckContext, onResult?: (result: CompletedCheck) => void): Promise<CompletedCheck[]>;
|
|
164
|
+
/**
|
|
165
|
+
* True when every required check passed. Warnings do not fail a run.
|
|
166
|
+
*
|
|
167
|
+
* Reads `CompletedCheck.severity`, which `runChecks` already set to the
|
|
168
|
+
* EFFECTIVE severity, so a context-promoted check fails the run here too.
|
|
169
|
+
*/
|
|
170
|
+
export declare function checksPassed(results: readonly CompletedCheck[]): boolean;
|
|
171
|
+
export interface CheckSummary {
|
|
172
|
+
passed: number;
|
|
173
|
+
warned: number;
|
|
174
|
+
failed: number;
|
|
175
|
+
skipped: number;
|
|
176
|
+
}
|
|
177
|
+
export declare function summarise(results: readonly CompletedCheck[]): CheckSummary;
|
|
178
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/engine/deploy/checks/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
import { accessSync, constants, readFileSync, readdirSync, statSync } from 'node:fs';
|
|
2
|
+
import { createServer } from 'node:net';
|
|
3
|
+
import { totalmem } from 'node:os';
|
|
4
|
+
import { connect as tlsConnect } from 'node:tls';
|
|
5
|
+
export const realFs = {
|
|
6
|
+
exists(path) {
|
|
7
|
+
try {
|
|
8
|
+
statSync(path);
|
|
9
|
+
return true;
|
|
10
|
+
}
|
|
11
|
+
catch {
|
|
12
|
+
return false;
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
isDirectory(path) {
|
|
16
|
+
try {
|
|
17
|
+
return statSync(path).isDirectory();
|
|
18
|
+
}
|
|
19
|
+
catch {
|
|
20
|
+
return false;
|
|
21
|
+
}
|
|
22
|
+
},
|
|
23
|
+
isWritable(path) {
|
|
24
|
+
try {
|
|
25
|
+
accessSync(path, constants.W_OK);
|
|
26
|
+
return true;
|
|
27
|
+
}
|
|
28
|
+
catch {
|
|
29
|
+
return false;
|
|
30
|
+
}
|
|
31
|
+
},
|
|
32
|
+
readFile(path) {
|
|
33
|
+
try {
|
|
34
|
+
return readFileSync(path, 'utf8');
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
return undefined;
|
|
38
|
+
}
|
|
39
|
+
},
|
|
40
|
+
readdir(path) {
|
|
41
|
+
try {
|
|
42
|
+
return readdirSync(path);
|
|
43
|
+
}
|
|
44
|
+
catch {
|
|
45
|
+
return [];
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
};
|
|
49
|
+
/**
|
|
50
|
+
* Reads the certificate a TLS server presents for `domain`.
|
|
51
|
+
*
|
|
52
|
+
* `rejectUnauthorized: false` because the question is WHICH certificate is
|
|
53
|
+
* served, not whether it is trusted -- an expired or staging certificate is
|
|
54
|
+
* exactly the one this has to be able to read. Nothing is sent after the
|
|
55
|
+
* handshake. Rejects on any failure; the caller decides what that means.
|
|
56
|
+
*/
|
|
57
|
+
export async function fetchServedCertificate(domain, options = {}) {
|
|
58
|
+
return await new Promise((resolve, reject) => {
|
|
59
|
+
const socket = tlsConnect({
|
|
60
|
+
host: domain,
|
|
61
|
+
port: options.port ?? 443,
|
|
62
|
+
servername: domain,
|
|
63
|
+
rejectUnauthorized: false,
|
|
64
|
+
});
|
|
65
|
+
socket.setTimeout(options.timeoutMs ?? 10_000, () => {
|
|
66
|
+
socket.destroy(new Error(`timed out reading the certificate served for ${domain}`));
|
|
67
|
+
});
|
|
68
|
+
socket.once('error', reject);
|
|
69
|
+
socket.once('secureConnect', () => {
|
|
70
|
+
const certificate = socket.getPeerCertificate();
|
|
71
|
+
socket.end();
|
|
72
|
+
const notAfter = new Date(certificate.valid_to ?? '');
|
|
73
|
+
if (Number.isNaN(notAfter.getTime())) {
|
|
74
|
+
reject(new Error(`unrecognised served expiry: ${String(certificate.valid_to)}`));
|
|
75
|
+
return;
|
|
76
|
+
}
|
|
77
|
+
resolve({ notAfter });
|
|
78
|
+
});
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* True when nothing is listening on the loopback address for `port`.
|
|
83
|
+
*
|
|
84
|
+
* Binding is used rather than parsing `ss` output: it needs no external tool,
|
|
85
|
+
* it cannot be confused by a different output format, and it answers the
|
|
86
|
+
* question that actually matters - can this deployment take the port.
|
|
87
|
+
*/
|
|
88
|
+
export async function isLoopbackPortFree(port) {
|
|
89
|
+
return await new Promise((resolve) => {
|
|
90
|
+
const server = createServer();
|
|
91
|
+
server.once('error', () => resolve(false));
|
|
92
|
+
server.once('listening', () => {
|
|
93
|
+
server.close(() => resolve(true));
|
|
94
|
+
});
|
|
95
|
+
server.listen(port, '127.0.0.1');
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
/** True when something answers on `port` of any interface. */
|
|
99
|
+
export async function isPortListening(port) {
|
|
100
|
+
return !(await new Promise((resolve) => {
|
|
101
|
+
const server = createServer();
|
|
102
|
+
server.once('error', () => resolve(false));
|
|
103
|
+
server.once('listening', () => {
|
|
104
|
+
server.close(() => resolve(true));
|
|
105
|
+
});
|
|
106
|
+
server.listen(port, '0.0.0.0');
|
|
107
|
+
}));
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* A check's EFFECTIVE severity in a context.
|
|
111
|
+
*
|
|
112
|
+
* ⚠ Everything that decides an exit code -- `requiredChecks`, `checksPassed`
|
|
113
|
+
* via `CompletedCheck.severity`, the doctor and preflight renderers -- goes
|
|
114
|
+
* through this, so a check promoted or demoted by its context is promoted or
|
|
115
|
+
* demoted everywhere at once rather than in whichever caller remembered.
|
|
116
|
+
*/
|
|
117
|
+
export function severityOf(check, context) {
|
|
118
|
+
if (check.severityFor === undefined)
|
|
119
|
+
return check.severity;
|
|
120
|
+
try {
|
|
121
|
+
return check.severityFor(context);
|
|
122
|
+
}
|
|
123
|
+
catch {
|
|
124
|
+
// Rule 1 extends to this: a broken severity function must not abort the
|
|
125
|
+
// run. The static severity is the documented fallback.
|
|
126
|
+
return check.severity;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
export function contextFs(context) {
|
|
130
|
+
return context.fs ?? realFs;
|
|
131
|
+
}
|
|
132
|
+
export function contextMemory(context) {
|
|
133
|
+
return (context.totalMemoryBytes ?? totalmem)();
|
|
134
|
+
}
|
|
135
|
+
export function contextPortFree(context) {
|
|
136
|
+
return context.portFree ?? isLoopbackPortFree;
|
|
137
|
+
}
|
|
138
|
+
export function contextServedCertificate(context) {
|
|
139
|
+
return context.servedCertificate ?? ((domain) => fetchServedCertificate(domain));
|
|
140
|
+
}
|
|
141
|
+
export function contextPortListening(context) {
|
|
142
|
+
return context.portListening ?? isPortListening;
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* Runs the registry in order, honouring `requires`.
|
|
146
|
+
*
|
|
147
|
+
* A check that throws is reported as a failure and the run continues - rule 1.
|
|
148
|
+
* `onResult` fires as each completes so a command can stream a checklist
|
|
149
|
+
* rather than appearing to hang through a dozen subprocess calls.
|
|
150
|
+
*/
|
|
151
|
+
export async function runChecks(checks, context, onResult) {
|
|
152
|
+
const results = [];
|
|
153
|
+
const byId = new Map();
|
|
154
|
+
for (const check of checks) {
|
|
155
|
+
const startedAt = Date.now();
|
|
156
|
+
const unmet = (check.requires ?? []).filter((id) => byId.get(id)?.status !== 'pass');
|
|
157
|
+
const result = unmet.length > 0
|
|
158
|
+
? {
|
|
159
|
+
status: 'skip',
|
|
160
|
+
// Named, so a wall of skips explains itself rather than looking
|
|
161
|
+
// like the checks silently did nothing.
|
|
162
|
+
detail: `skipped: ${unmet.join(', ')} did not pass`,
|
|
163
|
+
}
|
|
164
|
+
: await check.run(context).catch((error) => ({
|
|
165
|
+
status: 'fail',
|
|
166
|
+
detail: error instanceof Error ? error.message : String(error),
|
|
167
|
+
remedy: 'This check itself failed; the problem may be with appctl.',
|
|
168
|
+
}));
|
|
169
|
+
const completed = {
|
|
170
|
+
...result,
|
|
171
|
+
id: check.id,
|
|
172
|
+
title: check.title,
|
|
173
|
+
severity: severityOf(check, context),
|
|
174
|
+
durationMs: Date.now() - startedAt,
|
|
175
|
+
};
|
|
176
|
+
results.push(completed);
|
|
177
|
+
byId.set(check.id, completed);
|
|
178
|
+
onResult?.(completed);
|
|
179
|
+
}
|
|
180
|
+
return results;
|
|
181
|
+
}
|
|
182
|
+
/**
|
|
183
|
+
* True when every required check passed. Warnings do not fail a run.
|
|
184
|
+
*
|
|
185
|
+
* Reads `CompletedCheck.severity`, which `runChecks` already set to the
|
|
186
|
+
* EFFECTIVE severity, so a context-promoted check fails the run here too.
|
|
187
|
+
*/
|
|
188
|
+
export function checksPassed(results) {
|
|
189
|
+
return !results.some((result) => result.severity === 'required' && result.status === 'fail');
|
|
190
|
+
}
|
|
191
|
+
export function summarise(results) {
|
|
192
|
+
return {
|
|
193
|
+
passed: results.filter((result) => result.status === 'pass').length,
|
|
194
|
+
warned: results.filter((result) => result.status === 'warn').length,
|
|
195
|
+
failed: results.filter((result) => result.status === 'fail').length,
|
|
196
|
+
skipped: results.filter((result) => result.status === 'skip').length,
|
|
197
|
+
};
|
|
198
|
+
}
|
|
199
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/engine/deploy/checks/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { EnvGroup } from './env-metadata.js';
|
|
2
|
+
/** The group whose presence adds the telemetry stack. Always on; see above. */
|
|
3
|
+
export declare const TELEMETRY_GROUP: "observability";
|
|
4
|
+
/** Groups every VPS deployment has, whatever was passed or recorded. */
|
|
5
|
+
export declare const ALWAYS_ON_GROUPS: readonly EnvGroup[];
|
|
6
|
+
/**
|
|
7
|
+
* The groups a deployment actually runs with: the requested or recorded ones,
|
|
8
|
+
* plus every always-on group. Order is kept and duplicates dropped.
|
|
9
|
+
*
|
|
10
|
+
* THE ONE PLACE this is decided. Install, update, uninstall, health, the
|
|
11
|
+
* compose file list, the environment wizard and the update's drift check all
|
|
12
|
+
* route through it, so an existing deployment whose `state.groups` predates
|
|
13
|
+
* #567 gets the telemetry stack -- files and keys -- on its next update.
|
|
14
|
+
*
|
|
15
|
+
* @param groups - The requested or recorded groups.
|
|
16
|
+
* @returns Those groups plus every always-on and default-enabled one.
|
|
17
|
+
* @stability experimental
|
|
18
|
+
*/
|
|
19
|
+
export declare function effectiveGroups(groups?: readonly string[] | undefined): EnvGroup[];
|
|
20
|
+
/**
|
|
21
|
+
* The compose files for a deployment with these groups, in the order compose
|
|
22
|
+
* must apply them. File names only; callers join the directory. The telemetry
|
|
23
|
+
* files are always included (`effectiveGroups`). With `composeDir` (the
|
|
24
|
+
* checkout's infra/compose), the app's overlays found there come last.
|
|
25
|
+
*/
|
|
26
|
+
export declare function composeFilesFor(groups?: readonly string[] | undefined, composeDir?: string): string[];
|
|
27
|
+
/** `-f <file>` for each file, in order. */
|
|
28
|
+
export declare function composeFileArgs(groups?: readonly string[] | undefined, composeDir?: string): string[];
|
|
29
|
+
//# sourceMappingURL=compose-files.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compose-files.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/compose-files.ts"],"names":[],"mappings":"AA6DA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,+EAA+E;AAC/E,eAAO,MAAM,eAAe,iBAAqD,CAAC;AAiBlF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,SAAS,QAAQ,EAAsB,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE,CAWlF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAGrG;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAErG"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Which compose files make up this deployment (issue #531, epic #528)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// ONE list, read by every compose invocation: install, update, uninstall and
|
|
6
|
+
// the health gate. It used to be two hard-coded copies (install.ts and
|
|
7
|
+
// health.ts), which is how a stack ends up started with one set of files and
|
|
8
|
+
// inspected -- or torn down -- with another.
|
|
9
|
+
//
|
|
10
|
+
// The list depends on the deployment's groups, and those come from the flag
|
|
11
|
+
// on this run or from `state.groups` -- NEVER from reading the `.env`, for the
|
|
12
|
+
// reason `DeployState.groups` gives -- always widened by `effectiveGroups`.
|
|
13
|
+
//
|
|
14
|
+
// TELEMETRY IS ALWAYS ON for a VPS deployment (issue #567). `observability`
|
|
15
|
+
// used to be opt-in, and a deployment installed without it had no
|
|
16
|
+
// `greptimedb` container, so the admin telemetry page failed with "host
|
|
17
|
+
// greptimedb could not be resolved" and could only be fixed from a shell.
|
|
18
|
+
// Everything telemetry-related must be doable from the admin UI, so the stack
|
|
19
|
+
// ships with every deployment. Deploying it does not force export on:
|
|
20
|
+
// collection stays gated at runtime by the admin UI's telemetry toggle.
|
|
21
|
+
// `--group observability` is still accepted, as a harmless no-op.
|
|
22
|
+
//
|
|
23
|
+
// ORDER IS LOAD-BEARING:
|
|
24
|
+
//
|
|
25
|
+
// base, prod, [telemetry], vps, [vps.telemetry]
|
|
26
|
+
//
|
|
27
|
+
// - The VPS files come LAST. Their `ports: !override` only replaces what the
|
|
28
|
+
// files BEFORE them published; applied earlier, a later file's ports would
|
|
29
|
+
// merge back in and the service would be reachable on 0.0.0.0.
|
|
30
|
+
// - telemetry.compose.yml adds services, so it sits before the VPS files and
|
|
31
|
+
// inherits their hardening.
|
|
32
|
+
// - vps.telemetry.compose.yml is separate from vps.compose.yml because a
|
|
33
|
+
// service block for `greptimedb` in vps.compose.yml would be a service
|
|
34
|
+
// with no image on every deployment WITHOUT telemetry, and compose rejects
|
|
35
|
+
// the whole project for it.
|
|
36
|
+
//
|
|
37
|
+
// THE ORDER COMES FROM THE PACKAGE (issues #705, #714). Every file above is
|
|
38
|
+
// generated into infra/compose/ by @marinoscar/platform-infra (`npm run
|
|
39
|
+
// platform:infra:sync`), and the package's `composeFilesForMode('vps')` owns
|
|
40
|
+
// the order, so the deploy and every other consumer apply the same list.
|
|
41
|
+
//
|
|
42
|
+
// APP OVERLAYS COME LAST (#714). An app changes the stack with
|
|
43
|
+
// `infra/compose/app.*.compose.yml` files, never by editing a generated one.
|
|
44
|
+
// Given the checkout's compose directory, the list ends with the overlays
|
|
45
|
+
// that apply to a VPS deployment (`app.<name>`, `app.prod.<name>`,
|
|
46
|
+
// `app.vps.<name>`), sorted by file name, so they win:
|
|
47
|
+
//
|
|
48
|
+
// base, prod, [telemetry], vps, [vps.telemetry], app.*.compose.yml
|
|
49
|
+
//
|
|
50
|
+
// A name ending in `.example.compose.yml` is documentation and never applied.
|
|
51
|
+
// Without a directory (or when it cannot be read) the list has no overlays.
|
|
52
|
+
// =============================================================================
|
|
53
|
+
import { readdirSync } from 'node:fs';
|
|
54
|
+
import { composeFilesForMode } from '@marinoscar/platform-infra';
|
|
55
|
+
import { telemetryInfraFragment } from '@marinoscar/platform-infra/telemetry';
|
|
56
|
+
import { listEnvGroups } from '../../core/index.js';
|
|
57
|
+
import { ensurePlatformRegistrations } from '../builtin-registrations.js';
|
|
58
|
+
/** The group whose presence adds the telemetry stack. Always on; see above. */
|
|
59
|
+
export const TELEMETRY_GROUP = telemetryInfraFragment.envGroup;
|
|
60
|
+
/**
|
|
61
|
+
* The file names in the checkout's compose directory, where the app's
|
|
62
|
+
* overlays live. Empty when no directory is given or it cannot be read: a
|
|
63
|
+
* missing checkout must not turn into a thrown error here, the compose call
|
|
64
|
+
* that follows reports it with the right context.
|
|
65
|
+
*/
|
|
66
|
+
function composeDirListing(composeDir) {
|
|
67
|
+
if (composeDir === undefined)
|
|
68
|
+
return [];
|
|
69
|
+
try {
|
|
70
|
+
return readdirSync(composeDir);
|
|
71
|
+
}
|
|
72
|
+
catch {
|
|
73
|
+
return [];
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
/** Groups every VPS deployment has, whatever was passed or recorded. */
|
|
77
|
+
export const ALWAYS_ON_GROUPS = [TELEMETRY_GROUP];
|
|
78
|
+
/**
|
|
79
|
+
* The groups a deployment actually runs with: the requested or recorded ones,
|
|
80
|
+
* plus every always-on group. Order is kept and duplicates dropped.
|
|
81
|
+
*
|
|
82
|
+
* THE ONE PLACE this is decided. Install, update, uninstall, health, the
|
|
83
|
+
* compose file list, the environment wizard and the update's drift check all
|
|
84
|
+
* route through it, so an existing deployment whose `state.groups` predates
|
|
85
|
+
* #567 gets the telemetry stack -- files and keys -- on its next update.
|
|
86
|
+
*
|
|
87
|
+
* @param groups - The requested or recorded groups.
|
|
88
|
+
* @returns Those groups plus every always-on and default-enabled one.
|
|
89
|
+
* @stability experimental
|
|
90
|
+
*/
|
|
91
|
+
export function effectiveGroups(groups) {
|
|
92
|
+
ensurePlatformRegistrations();
|
|
93
|
+
// Always-on first, then every other registered group that is on by default
|
|
94
|
+
// (an app's `defaultEnabled` group): the platform's own default is the
|
|
95
|
+
// telemetry group alone, so a deployment without app groups is unchanged.
|
|
96
|
+
const defaults = listEnvGroups().filter((group) => group.defaultEnabled).map((group) => group.id);
|
|
97
|
+
const result = [];
|
|
98
|
+
for (const group of [...(groups ?? []), ...ALWAYS_ON_GROUPS, ...defaults]) {
|
|
99
|
+
if (!result.includes(group))
|
|
100
|
+
result.push(group);
|
|
101
|
+
}
|
|
102
|
+
return result;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* The compose files for a deployment with these groups, in the order compose
|
|
106
|
+
* must apply them. File names only; callers join the directory. The telemetry
|
|
107
|
+
* files are always included (`effectiveGroups`). With `composeDir` (the
|
|
108
|
+
* checkout's infra/compose), the app's overlays found there come last.
|
|
109
|
+
*/
|
|
110
|
+
export function composeFilesFor(groups, composeDir) {
|
|
111
|
+
const telemetry = effectiveGroups(groups).includes(TELEMETRY_GROUP);
|
|
112
|
+
return composeFilesForMode('vps', { telemetry, overlays: composeDirListing(composeDir) });
|
|
113
|
+
}
|
|
114
|
+
/** `-f <file>` for each file, in order. */
|
|
115
|
+
export function composeFileArgs(groups, composeDir) {
|
|
116
|
+
return composeFilesFor(groups, composeDir).flatMap((file) => ['-f', file]);
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=compose-files.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compose-files.js","sourceRoot":"","sources":["../../../src/engine/deploy/compose-files.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uEAAuE;AACvE,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,6EAA6E;AAC7E,6CAA6C;AAC7C,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,kEAAkE;AAClE,wEAAwE;AACxE,0EAA0E;AAC1E,8EAA8E;AAC9E,sEAAsE;AACtE,wEAAwE;AACxE,kEAAkE;AAClE,EAAE;AACF,yBAAyB;AACzB,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,mEAAmE;AACnE,+EAA+E;AAC/E,gCAAgC;AAChC,2EAA2E;AAC3E,2EAA2E;AAC3E,+EAA+E;AAC/E,gCAAgC;AAChC,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,yEAAyE;AACzE,EAAE;AACF,+DAA+D;AAC/D,6EAA6E;AAC7E,0EAA0E;AAC1E,mEAAmE;AACnE,uDAAuD;AACvD,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAI1E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC,QAA2B,CAAC;AAElF;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,UAA8B;IACvD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAwB,CAAC,eAAe,CAAC,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,MAAsC;IACpE,2BAA2B,EAAE,CAAC;IAC9B,2EAA2E;IAC3E,uEAAuE;IACvE,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClG,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,gBAAgB,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC;QAC1E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAiB,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAiB,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAsC,EAAE,UAAmB;IACzF,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACpE,OAAO,mBAAmB,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,eAAe,CAAC,MAAsC,EAAE,UAAmB;IACzF,OAAO,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/** Variables a compose failure text reports as required and empty, in order, once each. */
|
|
2
|
+
export declare function missingComposeVariables(text: string): string[];
|
|
3
|
+
/** The plain-language explanation for the given variables. */
|
|
4
|
+
export declare function composeMissingVariableHint(variables: readonly string[], envPath: string): string;
|
|
5
|
+
/**
|
|
6
|
+
* The same error with the hint appended when it is a compose "required variable"
|
|
7
|
+
* refusal; anything else comes back untouched. The original message (the compose
|
|
8
|
+
* output) is kept in full, and a `CommandFailedError` stays one, with its result.
|
|
9
|
+
*/
|
|
10
|
+
export declare function explainComposeFailure(error: unknown, envPath: string): unknown;
|
|
11
|
+
//# sourceMappingURL=compose-hints.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compose-hints.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/compose-hints.ts"],"names":[],"mappings":"AA6BA,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM9D;AAED,8DAA8D;AAC9D,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAehG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAc9E"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { cliName, cliVersion } from '../identity.js';
|
|
2
|
+
import { CommandFailedError } from './executor.js';
|
|
3
|
+
// =============================================================================
|
|
4
|
+
// A compose "required variable" refusal, explained (#1009)
|
|
5
|
+
// =============================================================================
|
|
6
|
+
//
|
|
7
|
+
// A compose file can refuse to start without a value (`${VAR:?message}`). The
|
|
8
|
+
// message names the variable and, at best, the file; it cannot say WHY the file
|
|
9
|
+
// has no value. On a real server it is almost always one of two things, and
|
|
10
|
+
// neither is visible from the compose output:
|
|
11
|
+
//
|
|
12
|
+
// 1. This CLI is older than the revision it is deploying. The CLI generates a
|
|
13
|
+
// new required secret (`autoGenerate`, e.g. STACK_AGENT_TOKEN) during
|
|
14
|
+
// `update`; a CLI built before the revision introduced it does not know
|
|
15
|
+
// the key exists, so the build fails at the first compose call. The CLI is
|
|
16
|
+
// updated separately from the application, which is what makes this easy
|
|
17
|
+
// to hit.
|
|
18
|
+
// 2. The key is missing or empty in the `.env` (deleted, never generated).
|
|
19
|
+
//
|
|
20
|
+
// So every place that runs compose against the deployment appends this hint,
|
|
21
|
+
// keeping the original output intact above it.
|
|
22
|
+
// =============================================================================
|
|
23
|
+
const REQUIRED_VARIABLE = /required variable ([A-Za-z_][A-Za-z0-9_]*) is missing a value/g;
|
|
24
|
+
/** Marker that keeps a re-thrown error from collecting the hint twice. */
|
|
25
|
+
const HINT_MARKER = 'Hint: docker compose refused to run';
|
|
26
|
+
/** Variables a compose failure text reports as required and empty, in order, once each. */
|
|
27
|
+
export function missingComposeVariables(text) {
|
|
28
|
+
const found = new Set();
|
|
29
|
+
for (const match of text.matchAll(REQUIRED_VARIABLE)) {
|
|
30
|
+
if (match[1] !== undefined)
|
|
31
|
+
found.add(match[1]);
|
|
32
|
+
}
|
|
33
|
+
return [...found];
|
|
34
|
+
}
|
|
35
|
+
/** The plain-language explanation for the given variables. */
|
|
36
|
+
export function composeMissingVariableHint(variables, envPath) {
|
|
37
|
+
const cli = cliName();
|
|
38
|
+
const names = variables.join(', ');
|
|
39
|
+
const noun = variables.length === 1 ? `${names} has` : `${names} have`;
|
|
40
|
+
return [
|
|
41
|
+
`${HINT_MARKER} because ${noun} no value in ${envPath}.`,
|
|
42
|
+
'There are two usual causes:',
|
|
43
|
+
` 1. This ${cli} (v${cliVersion()}) is older than the revision being deployed. The revision requires ${names}, ` +
|
|
44
|
+
`and only a newer ${cli} generates it during \`deploy update\`. The CLI is updated separately from the application: ` +
|
|
45
|
+
`update the CLI first (re-run its installer, or your bootstrap script's --update), then run ` +
|
|
46
|
+
`\`${cli} deploy update\` again. A plain retry is enough; --force is not needed.`,
|
|
47
|
+
` 2. The key is missing or empty in ${envPath}. Add ${variables.map((v) => `${v}=<value>`).join(' and ')} ` +
|
|
48
|
+
`there (for a token, \`openssl rand -hex 32\` makes a good one), then run \`${cli} deploy update\` again.`,
|
|
49
|
+
].join('\n');
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* The same error with the hint appended when it is a compose "required variable"
|
|
53
|
+
* refusal; anything else comes back untouched. The original message (the compose
|
|
54
|
+
* output) is kept in full, and a `CommandFailedError` stays one, with its result.
|
|
55
|
+
*/
|
|
56
|
+
export function explainComposeFailure(error, envPath) {
|
|
57
|
+
if (!(error instanceof Error))
|
|
58
|
+
return error;
|
|
59
|
+
if (error.message.includes(HINT_MARKER))
|
|
60
|
+
return error;
|
|
61
|
+
const result = error instanceof CommandFailedError ? error.result : undefined;
|
|
62
|
+
const variables = missingComposeVariables([error.message, result?.stderr ?? '', result?.stdout ?? ''].join('\n'));
|
|
63
|
+
if (variables.length === 0)
|
|
64
|
+
return error;
|
|
65
|
+
const message = `${error.message}\n\n${composeMissingVariableHint(variables, envPath)}`;
|
|
66
|
+
return result === undefined
|
|
67
|
+
? new Error(message, { cause: error })
|
|
68
|
+
: new CommandFailedError(message, result);
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=compose-hints.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compose-hints.js","sourceRoot":"","sources":["../../../src/engine/deploy/compose-hints.ts"],"names":[],"mappings":"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"}
|