From 43581eecbe58c94661ff44cac2f4df6465fedc8e Mon Sep 17 00:00:00 2001 From: kurtosisbot <89932784+kurtosisbot@users.noreply.github.com> Date: Wed, 27 Sep 2023 16:09:27 +0200 Subject: [PATCH] chore(main): release 0.83.10 (#1398) :robot: I have created a release *beep* *boop* --- ## [0.83.10](https://github.com/kurtosis-tech/kurtosis/compare/0.83.9...0.83.10) (2023-09-27) ### Features * disable scrollbar, remove line highlighting, set background color ([#1408](https://github.com/kurtosis-tech/kurtosis/issues/1408)) ([1ffdf10](https://github.com/kurtosis-tech/kurtosis/commit/1ffdf10e985b48e2cacc1f595590115a33f5834e)), closes [#1391](https://github.com/kurtosis-tech/kurtosis/issues/1391) * return the production enclave information if present via GetEnclaves API ([#1395](https://github.com/kurtosis-tech/kurtosis/issues/1395)) ([ef22820](https://github.com/kurtosis-tech/kurtosis/commit/ef22820cad6d98a784bb263435f3dd6e2bbbe31a)) ### Bug Fixes * add scrollbar ([#1400](https://github.com/kurtosis-tech/kurtosis/issues/1400)) ([40aba1d](https://github.com/kurtosis-tech/kurtosis/commit/40aba1ded6ac9b889486c6045332f1bb060ddea8)), closes [#1390](https://github.com/kurtosis-tech/kurtosis/issues/1390) * bring back args ([#1397](https://github.com/kurtosis-tech/kurtosis/issues/1397)) ([3e1c318](https://github.com/kurtosis-tech/kurtosis/commit/3e1c3188f58a91eb6428ddf17dfa95a0040551c3)) * text off center ([#1407](https://github.com/kurtosis-tech/kurtosis/issues/1407)) ([d845764](https://github.com/kurtosis-tech/kurtosis/commit/d8457640597696d6bfcd6c6e9f12864176bb8b35)), closes [#1406](https://github.com/kurtosis-tech/kurtosis/issues/1406) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: kurtosisbot Co-authored-by: Tedi Mitiku Co-authored-by: tedim52 --- CHANGELOG.md | 15 + LICENSE.md | 4 +- .../kurtosis_version/kurtosis_version.go | 2 +- api/rust/Cargo.toml | 2 +- api/typescript/package.json | 2 +- .../src/kurtosis_version/kurtosis_version.ts | 2 +- .../best-practices.md | 0 .../changelog.md | 51 ++++ .../cli-reference/analytics-disable.md | 0 .../cli-reference/analytics-enable.md | 0 .../cli-reference/analytics-id.md | 0 .../cli-reference/clean.md | 0 .../cli-reference/cluster-get.md | 0 .../cli-reference/cluster-ls.md | 0 .../cli-reference/cluster-set.md | 0 .../cli-reference/completion.md | 0 .../cli-reference/config-path.md | 0 .../cli-reference/discord.md | 0 .../cli-reference/docs.md | 0 .../cli-reference/dump.md | 0 .../cli-reference/enclave-add.md | 0 .../cli-reference/enclave-dump.md | 0 .../cli-reference/enclave-inspect.md | 0 .../cli-reference/enclave-ls.md | 0 .../cli-reference/enclave-rm.md | 0 .../cli-reference/enclave-stop.md | 0 .../cli-reference/engine-logs.md | 0 .../cli-reference/engine-restart.md | 0 .../cli-reference/engine-start.md | 0 .../cli-reference/engine-status.md | 0 .../cli-reference/engine-stop.md | 0 .../cli-reference/feedback.md | 0 .../cli-reference/files-download.md | 0 .../cli-reference/files-rendertemplate.md | 0 .../cli-reference/files-storeservice.md | 0 .../cli-reference/files-storeweb.md | 0 .../cli-reference/files-upload.md | 0 .../cli-reference/index.md | 0 .../cli-reference/lint.md | 0 .../cli-reference/port-print.md | 0 .../cli-reference/run.md | 0 .../cli-reference/service-add.md | 0 .../cli-reference/service-exec.md | 0 .../cli-reference/service-inspect.md | 0 .../cli-reference/service-logs.md | 4 +- .../cli-reference/service-rm.md | 0 .../cli-reference/service-shell.md | 0 .../cli-reference/service-start.md | 0 .../cli-reference/service-stop.md | 0 .../cli-reference/twitter.md | 0 .../cli-reference/version.md | 0 .../cli-reference/web.md | 0 .../code-examples.md | 0 .../concepts-reference/enclaves.md | 0 .../concepts-reference/files-artifacts.md | 0 .../concepts-reference/future-references.md | 0 .../concepts-reference/glossary.md | 0 .../concepts-reference/idempotent-runs.md | 0 .../concepts-reference/kurtosis-yml.md | 0 .../concepts-reference/locators.md | 0 .../concepts-reference/multi-phase-runs.md | 0 .../concepts-reference/packages.md | 0 .../concepts-reference/plan.md | 0 .../concepts-reference/resource-identifier.md | 0 .../concepts-reference/starlark.md | 0 .../engine-apic-reference.md | 0 .../explanations/architecture.md | 0 .../how-do-idempotent-runs-work.md | 0 .../how-do-kurtosis-imports-work.md | 0 .../explanations/metrics-philosophy.md | 0 .../public-and-private-ips-and-ports.md | 0 .../reusable-environment-definitions.md | 0 .../explanations/why-kurtosis-starlark.md | 0 .../explanations/why-multi-phase-runs.md | 0 .../explanations/why-we-built-kurtosis.md | 0 .../faq.md | 0 .../version-0.83.10/get-started/home.md | 55 ++++ .../get-started/quickstart-author.md} | 108 ++++---- .../version-0.83.10/get-started/quickstart.md | 259 ++++++++++++++++++ .../guides/adding-command-line-completion.md | 2 +- .../guides/how-to-compose-your-own-testnet.md | 1 + .../how-to-full-mev-with-eth2-package.md | 3 +- .../guides/how-to-local-eth-testnet.md | 2 +- .../guides/how-to-parameterize-cassandra.md | 2 +- .../guides/installing-historical-versions.md | 2 +- .../guides/installing-the-cli.md | 0 .../guides/running-in-ci.md | 1 + .../guides/running-in-k8s.md | 1 + .../guides/running-in-kurtosis-cloud.md | 1 + .../guides/upgrading-the-cli.md | 0 .../roadmap.md | 0 .../starlark-reference/directory.md | 0 .../starlark-reference/exec-recipe.md | 0 .../get-http-request-recipe.md | 0 .../starlark-reference/import-module.md | 0 .../starlark-reference/index.md | 0 .../starlark-reference/plan.md | 16 +- .../starlark-reference/port-spec.md | 0 .../post-http-request-recipe.md | 0 .../starlark-reference/read-file.md | 0 .../starlark-reference/ready-condition.md | 0 .../starlark-reference/service-config.md | 0 .../starlark-reference/service.md | 0 .../starlark-reference/standard-library.md | 0 .../version-0.83.5/get-started/home.md | 44 --- ...ars.json => version-0.83.10-sidebars.json} | 0 docs/versions.json | 2 +- version.txt | 2 +- 108 files changed, 474 insertions(+), 109 deletions(-) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/best-practices.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/changelog.md (96%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/analytics-disable.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/analytics-enable.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/analytics-id.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/clean.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/cluster-get.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/cluster-ls.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/cluster-set.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/completion.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/config-path.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/discord.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/docs.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/dump.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/enclave-add.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/enclave-dump.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/enclave-inspect.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/enclave-ls.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/enclave-rm.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/enclave-stop.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/engine-logs.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/engine-restart.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/engine-start.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/engine-status.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/engine-stop.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/feedback.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/files-download.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/files-rendertemplate.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/files-storeservice.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/files-storeweb.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/files-upload.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/index.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/lint.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/port-print.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/run.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/service-add.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/service-exec.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/service-inspect.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/service-logs.md (73%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/service-rm.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/service-shell.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/service-start.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/service-stop.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/twitter.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/version.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/cli-reference/web.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/code-examples.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/enclaves.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/files-artifacts.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/future-references.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/glossary.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/idempotent-runs.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/kurtosis-yml.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/locators.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/multi-phase-runs.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/packages.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/plan.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/resource-identifier.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/concepts-reference/starlark.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/engine-apic-reference.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/explanations/architecture.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/explanations/how-do-idempotent-runs-work.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/explanations/how-do-kurtosis-imports-work.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/explanations/metrics-philosophy.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/explanations/public-and-private-ips-and-ports.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/explanations/reusable-environment-definitions.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/explanations/why-kurtosis-starlark.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/explanations/why-multi-phase-runs.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/explanations/why-we-built-kurtosis.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/faq.md (100%) create mode 100644 docs/versioned_docs/version-0.83.10/get-started/home.md rename docs/versioned_docs/{version-0.83.5/get-started/quickstart.md => version-0.83.10/get-started/quickstart-author.md} (89%) create mode 100644 docs/versioned_docs/version-0.83.10/get-started/quickstart.md rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/adding-command-line-completion.md (99%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/how-to-compose-your-own-testnet.md (99%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/how-to-full-mev-with-eth2-package.md (98%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/how-to-local-eth-testnet.md (99%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/how-to-parameterize-cassandra.md (99%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/installing-historical-versions.md (99%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/installing-the-cli.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/running-in-ci.md (99%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/running-in-k8s.md (99%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/running-in-kurtosis-cloud.md (99%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/guides/upgrading-the-cli.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/roadmap.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/directory.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/exec-recipe.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/get-http-request-recipe.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/import-module.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/index.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/plan.md (97%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/port-spec.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/post-http-request-recipe.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/read-file.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/ready-condition.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/service-config.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/service.md (100%) rename docs/versioned_docs/{version-0.83.5 => version-0.83.10}/starlark-reference/standard-library.md (100%) delete mode 100644 docs/versioned_docs/version-0.83.5/get-started/home.md rename docs/versioned_sidebars/{version-0.83.5-sidebars.json => version-0.83.10-sidebars.json} (100%) diff --git a/CHANGELOG.md b/CHANGELOG.md index b251780995..6073c533c2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,20 @@ # Changelog +## [0.83.10](https://github.com/kurtosis-tech/kurtosis/compare/0.83.9...0.83.10) (2023-09-27) + + +### Features + +* disable scrollbar, remove line highlighting, set background color ([#1408](https://github.com/kurtosis-tech/kurtosis/issues/1408)) ([1ffdf10](https://github.com/kurtosis-tech/kurtosis/commit/1ffdf10e985b48e2cacc1f595590115a33f5834e)), closes [#1391](https://github.com/kurtosis-tech/kurtosis/issues/1391) +* return the production enclave information if present via GetEnclaves API ([#1395](https://github.com/kurtosis-tech/kurtosis/issues/1395)) ([ef22820](https://github.com/kurtosis-tech/kurtosis/commit/ef22820cad6d98a784bb263435f3dd6e2bbbe31a)) + + +### Bug Fixes + +* add scrollbar ([#1400](https://github.com/kurtosis-tech/kurtosis/issues/1400)) ([40aba1d](https://github.com/kurtosis-tech/kurtosis/commit/40aba1ded6ac9b889486c6045332f1bb060ddea8)), closes [#1390](https://github.com/kurtosis-tech/kurtosis/issues/1390) +* bring back args ([#1397](https://github.com/kurtosis-tech/kurtosis/issues/1397)) ([3e1c318](https://github.com/kurtosis-tech/kurtosis/commit/3e1c3188f58a91eb6428ddf17dfa95a0040551c3)) +* text off center ([#1407](https://github.com/kurtosis-tech/kurtosis/issues/1407)) ([d845764](https://github.com/kurtosis-tech/kurtosis/commit/d8457640597696d6bfcd6c6e9f12864176bb8b35)), closes [#1406](https://github.com/kurtosis-tech/kurtosis/issues/1406) + ## [0.83.9](https://github.com/kurtosis-tech/kurtosis/compare/0.83.8...0.83.9) (2023-09-26) diff --git a/LICENSE.md b/LICENSE.md index 58496a1253..86d778650e 100644 --- a/LICENSE.md +++ b/LICENSE.md @@ -3,7 +3,7 @@ Business Source License 1.1 Parameters Licensor: Kurtosis Technologies, Inc. -Licensed Work: Kurtosis 0.83.9 +Licensed Work: Kurtosis 0.83.10 The Licensed Work is (c) 2023 Kurtosis Technologies, Inc. Additional Use Grant: You may make use of the Licensed Work, provided that you may not use the Licensed Work for an Environment Orchestration Service. @@ -12,7 +12,7 @@ you may not use the Licensed Work for an Environment Orchestration Service. allows third parties (other than your employees and contractors) to create distributed system environments. -Change Date: 2027-09-26 +Change Date: 2027-09-27 Change License: AGPLv3 (GNU Affero General Public License Version 3) diff --git a/api/golang/kurtosis_version/kurtosis_version.go b/api/golang/kurtosis_version/kurtosis_version.go index f36bb9ab37..3004392fb1 100644 --- a/api/golang/kurtosis_version/kurtosis_version.go +++ b/api/golang/kurtosis_version/kurtosis_version.go @@ -9,6 +9,6 @@ const ( // !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!! // This is necessary so that Kurt Core consumers will know if they're compatible with the currently-running // API container - KurtosisVersion = "0.83.9" + KurtosisVersion = "0.83.10" // !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!! ) diff --git a/api/rust/Cargo.toml b/api/rust/Cargo.toml index 6340bf7b0e..d5bb27a709 100644 --- a/api/rust/Cargo.toml +++ b/api/rust/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "kurtosis-sdk" -version = "0.83.9" +version = "0.83.10" license = "BUSL-1.1" description = "Rust SDK for Kurtosis" edition = "2021" diff --git a/api/typescript/package.json b/api/typescript/package.json index adbf8794dc..1d5ae39d05 100644 --- a/api/typescript/package.json +++ b/api/typescript/package.json @@ -1,7 +1,7 @@ { "name": "kurtosis-sdk", "//": "NOTE: DO NOT UPDATE THIS VERSION MANUALLY - IT WILL BE UPDATED DURING THE RELEASE PROCESS!", - "version": "0.83.9", + "version": "0.83.10", "main": "./build/index", "description": "This repo contains a Typescript client for communicating with the Kurtosis Engine server, which is responsible for creating, managing and destroying Kurtosis Enclaves.", "types": "./build/index", diff --git a/api/typescript/src/kurtosis_version/kurtosis_version.ts b/api/typescript/src/kurtosis_version/kurtosis_version.ts index 7d6d3aa40b..4b06d80ecd 100644 --- a/api/typescript/src/kurtosis_version/kurtosis_version.ts +++ b/api/typescript/src/kurtosis_version/kurtosis_version.ts @@ -1,5 +1,5 @@ // !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!! // This is necessary so that Kurt Core consumers (e.g. modules) will know if they're compatible with the currently-running // API container -export const KURTOSIS_VERSION: string = "0.83.9" +export const KURTOSIS_VERSION: string = "0.83.10" // !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!! diff --git a/docs/versioned_docs/version-0.83.5/best-practices.md b/docs/versioned_docs/version-0.83.10/best-practices.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/best-practices.md rename to docs/versioned_docs/version-0.83.10/best-practices.md diff --git a/docs/versioned_docs/version-0.83.5/changelog.md b/docs/versioned_docs/version-0.83.10/changelog.md similarity index 96% rename from docs/versioned_docs/version-0.83.5/changelog.md rename to docs/versioned_docs/version-0.83.10/changelog.md index 1f2008b8aa..6073c533c2 100644 --- a/docs/versioned_docs/version-0.83.5/changelog.md +++ b/docs/versioned_docs/version-0.83.10/changelog.md @@ -1,5 +1,56 @@ # Changelog +## [0.83.10](https://github.com/kurtosis-tech/kurtosis/compare/0.83.9...0.83.10) (2023-09-27) + + +### Features + +* disable scrollbar, remove line highlighting, set background color ([#1408](https://github.com/kurtosis-tech/kurtosis/issues/1408)) ([1ffdf10](https://github.com/kurtosis-tech/kurtosis/commit/1ffdf10e985b48e2cacc1f595590115a33f5834e)), closes [#1391](https://github.com/kurtosis-tech/kurtosis/issues/1391) +* return the production enclave information if present via GetEnclaves API ([#1395](https://github.com/kurtosis-tech/kurtosis/issues/1395)) ([ef22820](https://github.com/kurtosis-tech/kurtosis/commit/ef22820cad6d98a784bb263435f3dd6e2bbbe31a)) + + +### Bug Fixes + +* add scrollbar ([#1400](https://github.com/kurtosis-tech/kurtosis/issues/1400)) ([40aba1d](https://github.com/kurtosis-tech/kurtosis/commit/40aba1ded6ac9b889486c6045332f1bb060ddea8)), closes [#1390](https://github.com/kurtosis-tech/kurtosis/issues/1390) +* bring back args ([#1397](https://github.com/kurtosis-tech/kurtosis/issues/1397)) ([3e1c318](https://github.com/kurtosis-tech/kurtosis/commit/3e1c3188f58a91eb6428ddf17dfa95a0040551c3)) +* text off center ([#1407](https://github.com/kurtosis-tech/kurtosis/issues/1407)) ([d845764](https://github.com/kurtosis-tech/kurtosis/commit/d8457640597696d6bfcd6c6e9f12864176bb8b35)), closes [#1406](https://github.com/kurtosis-tech/kurtosis/issues/1406) + +## [0.83.9](https://github.com/kurtosis-tech/kurtosis/compare/0.83.8...0.83.9) (2023-09-26) + + +### Bug Fixes + +* rebuild with type bug fix ([#1385](https://github.com/kurtosis-tech/kurtosis/issues/1385)) ([14840b7](https://github.com/kurtosis-tech/kurtosis/commit/14840b73509ddbf6ea4729a20703ea0d77c08da9)) +* restart log aggregator on failure ([#1371](https://github.com/kurtosis-tech/kurtosis/issues/1371)) ([7f171ce](https://github.com/kurtosis-tech/kurtosis/commit/7f171ce678ee8915d17c30262930365428d9a4f8)) + +## [0.83.8](https://github.com/kurtosis-tech/kurtosis/compare/0.83.7...0.83.8) (2023-09-26) + + +### Bug Fixes + +* handle missing arg types ([#1373](https://github.com/kurtosis-tech/kurtosis/issues/1373)) ([5cfea2a](https://github.com/kurtosis-tech/kurtosis/commit/5cfea2a0c62165193d258ad8d5bba48e06d4f5fb)) +* Relative import breaks for 'non-main branchs' ([#1364](https://github.com/kurtosis-tech/kurtosis/issues/1364)) ([5496082](https://github.com/kurtosis-tech/kurtosis/commit/549608269f21b2bf886c92263ee60989dc9fb4e1)), closes [#1361](https://github.com/kurtosis-tech/kurtosis/issues/1361) + +## [0.83.7](https://github.com/kurtosis-tech/kurtosis/compare/0.83.6...0.83.7) (2023-09-25) + + +### Features + +* improved log experience on the UI. ([#1368](https://github.com/kurtosis-tech/kurtosis/issues/1368)) ([760c7f0](https://github.com/kurtosis-tech/kurtosis/commit/760c7f0a33d3e2e9f777b509562901a8c6f25308)) + +## [0.83.6](https://github.com/kurtosis-tech/kurtosis/compare/0.83.5...0.83.6) (2023-09-22) + + +### Features + +* implement -n X and -a flags ([#1341](https://github.com/kurtosis-tech/kurtosis/issues/1341)) ([2c6880c](https://github.com/kurtosis-tech/kurtosis/commit/2c6880c9c251843dafacc3a356cc320f5efe85a7)) + + +### Bug Fixes + +* enclave manager ui was reading the wrong type fields ([#1367](https://github.com/kurtosis-tech/kurtosis/issues/1367)) ([0bae141](https://github.com/kurtosis-tech/kurtosis/commit/0bae141837324f94841f4e5f311cc7e2bbfa63a1)) +* Manually locate docker socket ([#1362](https://github.com/kurtosis-tech/kurtosis/issues/1362)) ([7fe4956](https://github.com/kurtosis-tech/kurtosis/commit/7fe49560b4d99c28e9bda640294bbe0554b57820)) + ## [0.83.5](https://github.com/kurtosis-tech/kurtosis/compare/0.83.4...0.83.5) (2023-09-21) diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/analytics-disable.md b/docs/versioned_docs/version-0.83.10/cli-reference/analytics-disable.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/analytics-disable.md rename to docs/versioned_docs/version-0.83.10/cli-reference/analytics-disable.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/analytics-enable.md b/docs/versioned_docs/version-0.83.10/cli-reference/analytics-enable.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/analytics-enable.md rename to docs/versioned_docs/version-0.83.10/cli-reference/analytics-enable.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/analytics-id.md b/docs/versioned_docs/version-0.83.10/cli-reference/analytics-id.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/analytics-id.md rename to docs/versioned_docs/version-0.83.10/cli-reference/analytics-id.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/clean.md b/docs/versioned_docs/version-0.83.10/cli-reference/clean.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/clean.md rename to docs/versioned_docs/version-0.83.10/cli-reference/clean.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/cluster-get.md b/docs/versioned_docs/version-0.83.10/cli-reference/cluster-get.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/cluster-get.md rename to docs/versioned_docs/version-0.83.10/cli-reference/cluster-get.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/cluster-ls.md b/docs/versioned_docs/version-0.83.10/cli-reference/cluster-ls.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/cluster-ls.md rename to docs/versioned_docs/version-0.83.10/cli-reference/cluster-ls.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/cluster-set.md b/docs/versioned_docs/version-0.83.10/cli-reference/cluster-set.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/cluster-set.md rename to docs/versioned_docs/version-0.83.10/cli-reference/cluster-set.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/completion.md b/docs/versioned_docs/version-0.83.10/cli-reference/completion.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/completion.md rename to docs/versioned_docs/version-0.83.10/cli-reference/completion.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/config-path.md b/docs/versioned_docs/version-0.83.10/cli-reference/config-path.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/config-path.md rename to docs/versioned_docs/version-0.83.10/cli-reference/config-path.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/discord.md b/docs/versioned_docs/version-0.83.10/cli-reference/discord.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/discord.md rename to docs/versioned_docs/version-0.83.10/cli-reference/discord.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/docs.md b/docs/versioned_docs/version-0.83.10/cli-reference/docs.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/docs.md rename to docs/versioned_docs/version-0.83.10/cli-reference/docs.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/dump.md b/docs/versioned_docs/version-0.83.10/cli-reference/dump.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/dump.md rename to docs/versioned_docs/version-0.83.10/cli-reference/dump.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/enclave-add.md b/docs/versioned_docs/version-0.83.10/cli-reference/enclave-add.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/enclave-add.md rename to docs/versioned_docs/version-0.83.10/cli-reference/enclave-add.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/enclave-dump.md b/docs/versioned_docs/version-0.83.10/cli-reference/enclave-dump.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/enclave-dump.md rename to docs/versioned_docs/version-0.83.10/cli-reference/enclave-dump.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/enclave-inspect.md b/docs/versioned_docs/version-0.83.10/cli-reference/enclave-inspect.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/enclave-inspect.md rename to docs/versioned_docs/version-0.83.10/cli-reference/enclave-inspect.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/enclave-ls.md b/docs/versioned_docs/version-0.83.10/cli-reference/enclave-ls.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/enclave-ls.md rename to docs/versioned_docs/version-0.83.10/cli-reference/enclave-ls.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/enclave-rm.md b/docs/versioned_docs/version-0.83.10/cli-reference/enclave-rm.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/enclave-rm.md rename to docs/versioned_docs/version-0.83.10/cli-reference/enclave-rm.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/enclave-stop.md b/docs/versioned_docs/version-0.83.10/cli-reference/enclave-stop.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/enclave-stop.md rename to docs/versioned_docs/version-0.83.10/cli-reference/enclave-stop.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/engine-logs.md b/docs/versioned_docs/version-0.83.10/cli-reference/engine-logs.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/engine-logs.md rename to docs/versioned_docs/version-0.83.10/cli-reference/engine-logs.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/engine-restart.md b/docs/versioned_docs/version-0.83.10/cli-reference/engine-restart.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/engine-restart.md rename to docs/versioned_docs/version-0.83.10/cli-reference/engine-restart.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/engine-start.md b/docs/versioned_docs/version-0.83.10/cli-reference/engine-start.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/engine-start.md rename to docs/versioned_docs/version-0.83.10/cli-reference/engine-start.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/engine-status.md b/docs/versioned_docs/version-0.83.10/cli-reference/engine-status.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/engine-status.md rename to docs/versioned_docs/version-0.83.10/cli-reference/engine-status.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/engine-stop.md b/docs/versioned_docs/version-0.83.10/cli-reference/engine-stop.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/engine-stop.md rename to docs/versioned_docs/version-0.83.10/cli-reference/engine-stop.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/feedback.md b/docs/versioned_docs/version-0.83.10/cli-reference/feedback.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/feedback.md rename to docs/versioned_docs/version-0.83.10/cli-reference/feedback.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/files-download.md b/docs/versioned_docs/version-0.83.10/cli-reference/files-download.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/files-download.md rename to docs/versioned_docs/version-0.83.10/cli-reference/files-download.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/files-rendertemplate.md b/docs/versioned_docs/version-0.83.10/cli-reference/files-rendertemplate.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/files-rendertemplate.md rename to docs/versioned_docs/version-0.83.10/cli-reference/files-rendertemplate.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/files-storeservice.md b/docs/versioned_docs/version-0.83.10/cli-reference/files-storeservice.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/files-storeservice.md rename to docs/versioned_docs/version-0.83.10/cli-reference/files-storeservice.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/files-storeweb.md b/docs/versioned_docs/version-0.83.10/cli-reference/files-storeweb.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/files-storeweb.md rename to docs/versioned_docs/version-0.83.10/cli-reference/files-storeweb.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/files-upload.md b/docs/versioned_docs/version-0.83.10/cli-reference/files-upload.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/files-upload.md rename to docs/versioned_docs/version-0.83.10/cli-reference/files-upload.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/index.md b/docs/versioned_docs/version-0.83.10/cli-reference/index.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/index.md rename to docs/versioned_docs/version-0.83.10/cli-reference/index.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/lint.md b/docs/versioned_docs/version-0.83.10/cli-reference/lint.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/lint.md rename to docs/versioned_docs/version-0.83.10/cli-reference/lint.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/port-print.md b/docs/versioned_docs/version-0.83.10/cli-reference/port-print.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/port-print.md rename to docs/versioned_docs/version-0.83.10/cli-reference/port-print.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/run.md b/docs/versioned_docs/version-0.83.10/cli-reference/run.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/run.md rename to docs/versioned_docs/version-0.83.10/cli-reference/run.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/service-add.md b/docs/versioned_docs/version-0.83.10/cli-reference/service-add.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/service-add.md rename to docs/versioned_docs/version-0.83.10/cli-reference/service-add.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/service-exec.md b/docs/versioned_docs/version-0.83.10/cli-reference/service-exec.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/service-exec.md rename to docs/versioned_docs/version-0.83.10/cli-reference/service-exec.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/service-inspect.md b/docs/versioned_docs/version-0.83.10/cli-reference/service-inspect.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/service-inspect.md rename to docs/versioned_docs/version-0.83.10/cli-reference/service-inspect.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/service-logs.md b/docs/versioned_docs/version-0.83.10/cli-reference/service-logs.md similarity index 73% rename from docs/versioned_docs/version-0.83.5/cli-reference/service-logs.md rename to docs/versioned_docs/version-0.83.10/cli-reference/service-logs.md index 25d07a1eb1..f7c62c5f2c 100644 --- a/docs/versioned_docs/version-0.83.5/cli-reference/service-logs.md +++ b/docs/versioned_docs/version-0.83.10/cli-reference/service-logs.md @@ -13,10 +13,12 @@ kurtosis service logs $THE_ENCLAVE_IDENTIFIER $THE_SERVICE_IDENTIFIER where `$THE_ENCLAVE_IDENTIFIER` and the `$THE_SERVICE_IDENTIFIER` are [resource identifiers](../concepts-reference/resource-identifier.md) for the enclave and service, respectively. The service identifier (name or UUID) is printed upon inspecting an enclave. :::note Number of log lines -By default, logs printed in the terminal from this command are truncated at 200 lines. For a stream of logs, we recommend the `-f` flag. For a snapshot of the logs at a given point in time (e.g. after a change), we recommend the [`kurtosis dump`](./dump.md). +By default, logs printed in the terminal from this command are truncated at the most recent 200 log lines. For a stream of logs, we recommend the `-f` flag. For all the logs use the `-a` flag and for a snapshot of the logs at a given point in time (e.g. after a change), we recommend the [`kurtosis dump`](./dump.md). ::: The following optional arguments can be used: +1. `-a`, `--all` can be used to retrieve all logs. +1. `-n`, `--num=uint32` can be used to retrieve X last log lines. (eg. `-n 10` will retrieve last 10 log lines, similar to `tail -n 10`) 1. `-f`, `-follow` can be added to continue following the logs, similar to `tail -f`. 1. `--match=text` can be used for filtering the log lines containing the text. 1. `--regex-match="regex"` can be used for filtering the log lines containing the regex. This filter will also work for text but will have degraded performance. diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/service-rm.md b/docs/versioned_docs/version-0.83.10/cli-reference/service-rm.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/service-rm.md rename to docs/versioned_docs/version-0.83.10/cli-reference/service-rm.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/service-shell.md b/docs/versioned_docs/version-0.83.10/cli-reference/service-shell.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/service-shell.md rename to docs/versioned_docs/version-0.83.10/cli-reference/service-shell.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/service-start.md b/docs/versioned_docs/version-0.83.10/cli-reference/service-start.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/service-start.md rename to docs/versioned_docs/version-0.83.10/cli-reference/service-start.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/service-stop.md b/docs/versioned_docs/version-0.83.10/cli-reference/service-stop.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/service-stop.md rename to docs/versioned_docs/version-0.83.10/cli-reference/service-stop.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/twitter.md b/docs/versioned_docs/version-0.83.10/cli-reference/twitter.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/twitter.md rename to docs/versioned_docs/version-0.83.10/cli-reference/twitter.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/version.md b/docs/versioned_docs/version-0.83.10/cli-reference/version.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/version.md rename to docs/versioned_docs/version-0.83.10/cli-reference/version.md diff --git a/docs/versioned_docs/version-0.83.5/cli-reference/web.md b/docs/versioned_docs/version-0.83.10/cli-reference/web.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/cli-reference/web.md rename to docs/versioned_docs/version-0.83.10/cli-reference/web.md diff --git a/docs/versioned_docs/version-0.83.5/code-examples.md b/docs/versioned_docs/version-0.83.10/code-examples.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/code-examples.md rename to docs/versioned_docs/version-0.83.10/code-examples.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/enclaves.md b/docs/versioned_docs/version-0.83.10/concepts-reference/enclaves.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/enclaves.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/enclaves.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/files-artifacts.md b/docs/versioned_docs/version-0.83.10/concepts-reference/files-artifacts.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/files-artifacts.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/files-artifacts.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/future-references.md b/docs/versioned_docs/version-0.83.10/concepts-reference/future-references.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/future-references.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/future-references.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/glossary.md b/docs/versioned_docs/version-0.83.10/concepts-reference/glossary.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/glossary.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/glossary.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/idempotent-runs.md b/docs/versioned_docs/version-0.83.10/concepts-reference/idempotent-runs.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/idempotent-runs.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/idempotent-runs.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/kurtosis-yml.md b/docs/versioned_docs/version-0.83.10/concepts-reference/kurtosis-yml.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/kurtosis-yml.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/kurtosis-yml.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/locators.md b/docs/versioned_docs/version-0.83.10/concepts-reference/locators.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/locators.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/locators.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/multi-phase-runs.md b/docs/versioned_docs/version-0.83.10/concepts-reference/multi-phase-runs.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/multi-phase-runs.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/multi-phase-runs.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/packages.md b/docs/versioned_docs/version-0.83.10/concepts-reference/packages.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/packages.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/packages.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/plan.md b/docs/versioned_docs/version-0.83.10/concepts-reference/plan.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/plan.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/plan.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/resource-identifier.md b/docs/versioned_docs/version-0.83.10/concepts-reference/resource-identifier.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/resource-identifier.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/resource-identifier.md diff --git a/docs/versioned_docs/version-0.83.5/concepts-reference/starlark.md b/docs/versioned_docs/version-0.83.10/concepts-reference/starlark.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/concepts-reference/starlark.md rename to docs/versioned_docs/version-0.83.10/concepts-reference/starlark.md diff --git a/docs/versioned_docs/version-0.83.5/engine-apic-reference.md b/docs/versioned_docs/version-0.83.10/engine-apic-reference.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/engine-apic-reference.md rename to docs/versioned_docs/version-0.83.10/engine-apic-reference.md diff --git a/docs/versioned_docs/version-0.83.5/explanations/architecture.md b/docs/versioned_docs/version-0.83.10/explanations/architecture.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/explanations/architecture.md rename to docs/versioned_docs/version-0.83.10/explanations/architecture.md diff --git a/docs/versioned_docs/version-0.83.5/explanations/how-do-idempotent-runs-work.md b/docs/versioned_docs/version-0.83.10/explanations/how-do-idempotent-runs-work.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/explanations/how-do-idempotent-runs-work.md rename to docs/versioned_docs/version-0.83.10/explanations/how-do-idempotent-runs-work.md diff --git a/docs/versioned_docs/version-0.83.5/explanations/how-do-kurtosis-imports-work.md b/docs/versioned_docs/version-0.83.10/explanations/how-do-kurtosis-imports-work.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/explanations/how-do-kurtosis-imports-work.md rename to docs/versioned_docs/version-0.83.10/explanations/how-do-kurtosis-imports-work.md diff --git a/docs/versioned_docs/version-0.83.5/explanations/metrics-philosophy.md b/docs/versioned_docs/version-0.83.10/explanations/metrics-philosophy.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/explanations/metrics-philosophy.md rename to docs/versioned_docs/version-0.83.10/explanations/metrics-philosophy.md diff --git a/docs/versioned_docs/version-0.83.5/explanations/public-and-private-ips-and-ports.md b/docs/versioned_docs/version-0.83.10/explanations/public-and-private-ips-and-ports.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/explanations/public-and-private-ips-and-ports.md rename to docs/versioned_docs/version-0.83.10/explanations/public-and-private-ips-and-ports.md diff --git a/docs/versioned_docs/version-0.83.5/explanations/reusable-environment-definitions.md b/docs/versioned_docs/version-0.83.10/explanations/reusable-environment-definitions.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/explanations/reusable-environment-definitions.md rename to docs/versioned_docs/version-0.83.10/explanations/reusable-environment-definitions.md diff --git a/docs/versioned_docs/version-0.83.5/explanations/why-kurtosis-starlark.md b/docs/versioned_docs/version-0.83.10/explanations/why-kurtosis-starlark.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/explanations/why-kurtosis-starlark.md rename to docs/versioned_docs/version-0.83.10/explanations/why-kurtosis-starlark.md diff --git a/docs/versioned_docs/version-0.83.5/explanations/why-multi-phase-runs.md b/docs/versioned_docs/version-0.83.10/explanations/why-multi-phase-runs.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/explanations/why-multi-phase-runs.md rename to docs/versioned_docs/version-0.83.10/explanations/why-multi-phase-runs.md diff --git a/docs/versioned_docs/version-0.83.5/explanations/why-we-built-kurtosis.md b/docs/versioned_docs/version-0.83.10/explanations/why-we-built-kurtosis.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/explanations/why-we-built-kurtosis.md rename to docs/versioned_docs/version-0.83.10/explanations/why-we-built-kurtosis.md diff --git a/docs/versioned_docs/version-0.83.5/faq.md b/docs/versioned_docs/version-0.83.10/faq.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/faq.md rename to docs/versioned_docs/version-0.83.10/faq.md diff --git a/docs/versioned_docs/version-0.83.10/get-started/home.md b/docs/versioned_docs/version-0.83.10/get-started/home.md new file mode 100644 index 0000000000..fc283085c8 --- /dev/null +++ b/docs/versioned_docs/version-0.83.10/get-started/home.md @@ -0,0 +1,55 @@ +--- +title: Introduction +sidebar_label: Introduction +slug: '/' +sidebar_position: 1 +hide_table_of_contents: true +--- + +## What is Kurtosis? +[Kurtosis](https://www.kurtosis.com) is a platform for packaging and launching environments of containerized services ("distributed applications") with a focus on approachability for the average developer. What Docker did for shipping binaries, Kurtosis aims to do even better for distributed applications. + +Kurtosis is formed of: + +- A language for declaring a distributed application in Python syntax ([Starlark](https://github.com/google/starlark-go/blob/master/doc/spec.md)) +- A packaging system for sharing and reusing distributed application components +- A runtime that makes a Kurtosis app Just Work, independent of whether it's running on Docker or Kubernetes, local or in the cloud +- A set of tools to ease common distributed app development needs (e.g. a log aggregator to ease log-diving, automatic port-forwarding to ease connectivity, a `kurtosis service shell` command to ease container filesystem exploration, etc.) + +Go [here](../explanations/why-we-built-kurtosis.md) to learn more about what inspired us to build Kurtosis. + +## Why should I use Kurtosis? +Kurtosis shines when creating, working with, and destroying self-contained distributed application environments. Currently, our users report this to be most useful when: + +- You're developing on your application and you need to rapidly iterate on it +- You want to try someone's containerized service or distributed application without setting up an environment, dependencies, etc. +- You want to spin up your distributed application in ephemeral environments as part of your integration tests +- You want to ad-hoc test your application on a big cloud cluster +- You're the author of a containerized service or distributed application and you want to give your users a one-liner to try it +- You want to get an instance of your application running in the cloud without provisioning or administering a Kubernetes cluster + +If you're in web3, we have even more specific web3 usecases [here](https://web3.kurtosis.com). + +## Architecture + +#### Kurtosis has a definition language of: +- An instruction set of useful primitives for setting up and manipulating environments +- A scriptable Python-like SDK in Starlark, a build language used by Google’s Bazel +- A package management system for shareability and composability + +#### Kurtosis has a validator with: +- Compile-time safety to quickly catch errors in test environment definitions +- The ability to dry-run test environment definitions to verify what will be run, before running + +#### Kurtosis has a runtime to: +- Run multi-container test environments over Docker or Kubernetes, depending on how you wish to scale +- Enable debugging and investigation of problems live, as they're happening in your test environment +- Manage file dependencies to ensure complete portability of test environments across different test runs and backends + +## Try out Kurtosis now + +Try Kurtosis now with our [quickstart](./quickstart.md). + +:::info +If you have questions, need help, or simply want to learn more, schedule a live session with us, go [here](https://calendly.com/d/zgt-f2c-66p/kurtosis-onboarding). +::: diff --git a/docs/versioned_docs/version-0.83.5/get-started/quickstart.md b/docs/versioned_docs/version-0.83.10/get-started/quickstart-author.md similarity index 89% rename from docs/versioned_docs/version-0.83.5/get-started/quickstart.md rename to docs/versioned_docs/version-0.83.10/get-started/quickstart-author.md index af4e6a9026..46be6fe1b5 100644 --- a/docs/versioned_docs/version-0.83.5/get-started/quickstart.md +++ b/docs/versioned_docs/version-0.83.10/get-started/quickstart-author.md @@ -1,16 +1,17 @@ --- -title: Quickstart -sidebar_label: Quickstart -slug: /quickstart +title: Quickstart - Write a Package +sidebar_label: Quickstart - Write a Package +slug: /quickstart-write-a-package toc_max_heading_level: 2 +sidebar_position: 2 --- Introduction ------------ -Welcome to the [Kurtosis][homepage] quickstart! This guide takes ~15 minutes and will walk you through building a basic Kurtosis package. This guide is in a "code along" format, meaning we assume the user will be following the code examples and running Kurtosis CLI commands on your local machine. Everything you run in this guide is free, public, and does not contain any sensitive data. +Welcome! This guide will walk you through how a [Kurtosis package][packages-reference] author would define their environment definition using Kurtosis. This guide takes ~15 minutes and will walk you through setting up a basic Postgres database and an API server to automate the loading of data. This guide is in a "code along" format, meaning we assume the user will be following the code examples and running Kurtosis CLI commands on your local machine. Everything you run in this guide is free, public, and does not contain any sensitive data. -For a quick read on what Kurtosis is and what problems Kurtosis aims to solve, our [introduction page][homepage] will be a great starting point, alongside our [motivations behind starting Kurtosis][why-we-built-kurtosis-explanation]. +This quickstart is meant for authors of environment definitions and is a continuation of the [quickstart for package consumers][quickstart-consumers]. While you may choose to do the quickstarts in any order, it is recommended that you start with the [quickstart for package consumers][quickstart-consumers] before this one. Doing both is highly recommended to understand how Kurtosis aims to solve the environment definition author-consumer divide to make building distributed systems as easy as building single server applications. :::tip What You'll Do @@ -18,6 +19,7 @@ For a quick read on what Kurtosis is and what problems Kurtosis aims to solve, o - Seed your database with test data using task sequencing - Connect an API server to your database using dynamic service dependencies - Parameterize your application setup in order to automate loading data into your API +- Make your Kurtosis package consumable by any user :::
TL;DR Version @@ -45,7 +47,7 @@ Hello, World First, create and `cd` into a directory to hold the project you'll be working on: ```bash -mkdir kurtosis-quickstart && cd kurtosis-quickstart +mkdir kurtosis-postgres && cd kurtosis-postgres ``` Next, create a Starlark file called `main.star` inside your new directory with the following contents (more on Starlark in the "Review" section coming up soon): @@ -69,23 +71,23 @@ autocmd FileType *.star setlocal filetype=python Finally, [run][kurtosis-run-reference] the script (we'll explain enclaves in the "Review" section): ```bash -kurtosis run --enclave quickstart main.star +kurtosis run --enclave kurtosis-postgres main.star ``` Kurtosis will work for a bit, and then deliver you the following result: ```text INFO[2023-03-15T04:27:01-03:00] Creating a new enclave for Starlark to run inside... -INFO[2023-03-15T04:27:05-03:00] Enclave 'quickstart' created successfully +INFO[2023-03-15T04:27:05-03:00] Enclave 'kurtosis-postgres' created successfully > print msg="Hello, world" Hello, world Starlark code successfully run. No output was returned. INFO[2023-03-15T04:27:05-03:00] =================================================== -INFO[2023-03-15T04:27:05-03:00] || Created enclave: quickstart || +INFO[2023-03-15T04:27:05-03:00] || Created enclave: kurtosis-postgres || INFO[2023-03-15T04:27:05-03:00] =================================================== -Name: quickstart +Name: kurtosis-postgres UUID: a78f2ce1ca68 Status: RUNNING Creation Time: Wed, 15 Mar 2023 04:27:01 -03 @@ -140,22 +142,22 @@ def run(plan, args): ) ``` -Before you run the above command, remember that you still have the `quickstart` enclave hanging around from the previous section. To [clean up the previous enclave][kurtosis-clean-reference] and execute our new `main.star` file above, run: +Before you run the above command, remember that you still have the `kurtosis-postgres` enclave hanging around from the previous section. To [clean up the previous enclave][kurtosis-clean-reference] and execute our new `main.star` file above, run: ```bash -kurtosis clean -a && kurtosis run --enclave quickstart main.star +kurtosis clean -a && kurtosis run --enclave kurtosis-postgres main.star ``` :::info The `--enclave` flag is used to specify the enclave to use for that particular run. If one doesn't exist, Kurtosis will create an enclave with that name - which is what is happening here. Read more about `kurtosis run` [here][kurtosis-run-reference]. -This entire "clean-and-run" process will be your dev loop for the rest of the quickstart as you add more services and operations to our distributed application. +This entire "clean-and-run" process will be your dev loop for the rest of the kurtosis-postgres as you add more services and operations to our distributed application. ::: -You'll see in the result that the `quickstart` enclave now contains a Postgres instance: +You'll see in the result that the `kurtosis-postgres` enclave now contains a Postgres instance: ```text -Name: quickstart +Name: kurtosis-postgres UUID: a30106a0bb87 Status: RUNNING Creation Time: Tue, 14 Mar 2023 20:23:54 -03 @@ -202,10 +204,10 @@ By contrast, Kurtosis Starlark scripts can use data as a first-class primitive a Let's see it in action, and we'll explain what's happening afterwards. -First, create a file called `kurtosis.yml` next to your `main.star file` (in your working directory, `kurtosis-quickstart`) with the following contents: +First, create a file called `kurtosis.yml` next to your `main.star file` (in your working directory, `kurtosis-postgres`) with the following contents: ```bash -name: "github.com/john-snow/kurtosis-quickstart" +name: "github.com/john-snow/kurtosis-postgres" ``` Then update your `main.star` with the following: @@ -258,7 +260,7 @@ def run(plan, args): Now, run the following to see what happens: ```bash -kurtosis clean -a && kurtosis run --enclave quickstart . +kurtosis clean -a && kurtosis run --enclave kurtosis-postgres . ``` (Notice you are using `.` instead of `main.star`) @@ -268,15 +270,15 @@ The output should also look more interesting as your plan has grown bigger: ```text INFO[2023-03-15T04:34:06-03:00] Cleaning enclaves... INFO[2023-03-15T04:34:06-03:00] Successfully removed the following enclaves: -60601dd9906e40d6af5f16b233a56ae7 quickstart +60601dd9906e40d6af5f16b233a56ae7 kurtosis-postgres INFO[2023-03-15T04:34:06-03:00] Successfully cleaned enclaves INFO[2023-03-15T04:34:06-03:00] Cleaning old Kurtosis engine containers... INFO[2023-03-15T04:34:06-03:00] Successfully cleaned old Kurtosis engine containers INFO[2023-03-15T04:34:06-03:00] Creating a new enclave for Starlark to run inside... -INFO[2023-03-15T04:34:10-03:00] Enclave 'quickstart' created successfully -INFO[2023-03-15T04:34:10-03:00] Executing Starlark package at '/tmp/kurtosis-quickstart' as the passed argument '.' looks like a directory -INFO[2023-03-15T04:34:10-03:00] Compressing package 'github.com/john-snow/kurtosis-quickstart' at '.' for upload -INFO[2023-03-15T04:34:10-03:00] Uploading and executing package 'github.com/john-snow/kurtosis-quickstart' +INFO[2023-03-15T04:34:10-03:00] Enclave 'kurtosis-postgres' created successfully +INFO[2023-03-15T04:34:10-03:00] Executing Starlark package at '/tmp/kurtosis-postgres' as the passed argument '.' looks like a directory +INFO[2023-03-15T04:34:10-03:00] Compressing package 'github.com/john-snow/kurtosis-postgres' at '.' for upload +INFO[2023-03-15T04:34:10-03:00] Uploading and executing package 'github.com/john-snow/kurtosis-postgres' > upload_files src="github.com/kurtosis-tech/awesome-kurtosis/data-package/dvd-rental-data.tar" Files with artifact name 'howling-thunder' uploaded with artifact UUID '32810fc8c131414882c52b044318b2fd' @@ -289,9 +291,9 @@ Command returned with exit code '0' with no output Starlark code successfully run. No output was returned. INFO[2023-03-15T04:34:21-03:00] =================================================== -INFO[2023-03-15T04:34:21-03:00] || Created enclave: quickstart || +INFO[2023-03-15T04:34:21-03:00] || Created enclave: kurtosis-postgres || INFO[2023-03-15T04:34:21-03:00] =================================================== -Name: quickstart +Name: kurtosis-postgres UUID: 995fe0ca69fe Status: RUNNING Creation Time: Wed, 15 Mar 2023 04:34:06 -03 @@ -308,7 +310,7 @@ f1d9cab2ca34 postgres postgres: 5432/tcp -> postgresql://127.0.0.1:62914 R Does your Postgres have data now? Let's find out by opening a shell on the Postgres container and logging into the database: ```bash -kurtosis service shell quickstart postgres +kurtosis service shell kurtosis-postgres postgres ``` From there, listing the tables in the Postgres can be done with: @@ -489,7 +491,7 @@ def run(plan, args): Now, run the same dev loop command as before (and don't worry about the result, we'll explain that later): ```bash -kurtosis clean -a && kurtosis run --enclave quickstart . +kurtosis clean -a && kurtosis run --enclave kurtosis-postgres . ``` We just got a failure, just like we might when building a real system! @@ -531,7 +533,7 @@ The enclave state is usually a good place to find mor clues. If you look at the ```text -Name: quickstart +Name: kurtosis-postgres UUID: 5b360f940bcc Status: RUNNING Creation Time: Tue, 14 Mar 2023 22:15:19 -03 @@ -550,7 +552,7 @@ From the above, we can see that the PostgREST service (named: `api`) is not in t You can also grab the PostgREST logs... ```bash -kurtosis service logs quickstart api +kurtosis service logs kurtosis-postgres api ``` ...we can see that the PostgREST is dying: @@ -601,13 +603,13 @@ def run(plan, args): In the line declaring the `postgres_url` variable in your `main.star` file, replace the `"postgres",` string with `POSTGRES_USER,` to use the correct username we specified at the beginning of our file. Then re-run your dev loop: ```bash -kurtosis clean -a && kurtosis run --enclave quickstart . +kurtosis clean -a && kurtosis run --enclave kurtosis-postgres . ``` Now at the bottom of the output we can see that the PostgREST service is `RUNNING` correctly: ```text -Name: quickstart +Name: kurtosis-postgres UUID: 11c0ac047299 Status: RUNNING Creation Time: Tue, 14 Mar 2023 22:30:02 -03 @@ -666,7 +668,7 @@ Now that you have an API, you should be able to interact with the data. [Inspect][kurtosis-enclave-inspect-reference] your enclave: ```bash -kurtosis enclave inspect quickstart +kurtosis enclave inspect kurtosis-postgres ``` Notice how Kurtosis automatically exposed the PostgREST container's `http` port to your machine: @@ -679,7 +681,7 @@ Notice how Kurtosis automatically exposed the PostgREST container's `http` port In this output the `http` port is exposed as URL `http://127.0.0.1:59992`, but your port number will be different. ::: -You can paste the URL from your output into your browser (or Cmd+click if you're using [iTerm][iterm]) to verify that you are indeed talking to the PostgREST inside your `quickstart` enclave: +You can paste the URL from your output into your browser (or Cmd+click if you're using [iTerm][iterm]) to verify that you are indeed talking to the PostgREST inside your `kurtosis-postgres` enclave: ```json {"swagger":"2.0","info":{"description":"","title":"standard public schema","version":"10.2.0.20230209 (pre-release) (a1e2fe3)"},"host":"0.0.0.0:3000","basePath":"/","schemes":["http"],"consumes":["application/json","application/vnd.pgrst.object+json","text/csv"],"produces":["application/json","application/vnd.pgrst.object+json","text/csv"],"paths":{"/":{"get":{"tags":["Introspection"],"summary":"OpenAPI description (this document)","produces":["application/openapi+json","application/json"],"responses":{"200":{"description":"OK"}}}},"/actor":{"get":{"tags":["actor"],"parameters":[{"$ref":"#/parameters/rowFilter.actor.actor_id"},{"$ref":"#/parameters/rowFilter.actor.first_name"},{"$ref":"#/parameters/rowFilter.actor.last_name"},{"$ref":"#/parameters/rowFilter.actor.last_update"},{"$ref":"#/parameters/select"},{"$ref":"#/parameters/order"},{"$ref":"#/parameters/range"},{"$ref":"#/parameters/rangeUnit"},{"$ref":"#/parameters/offset"},{"$ref":"#/parameters/limit"},{"$ref":"#/parameters/preferCount"}], ... @@ -831,7 +833,22 @@ def run(plan, args): **This section showed how to interact with your test environment, and also how to parametrize it for others to easily modify and re-use.** +Publishing your Kurtosis Package for others to use +-------------------------------------------------- +At this point, you should have 2 files: +1. `main.star` +2. `kurtosis.yml` + +Publishing these 2 files to a Github repository will enable anyone with Kurtosis and an internet connection to instantiate the environment you described in your `main.star` file. These files, alongside a directory that you will create on Github, form the basis for a [Kurtosis package][packages-reference] + +Once you've uploaded it to a Github repository, anyone can spin up the same system - in any way they want (using your parameters) and anywhere they want (e.g. Docker, Kubernetes, local, remote, etc). + +As an example, a consumer of the Kurtosis package need only run the following command to reproduce the system and add another row to the database of actors: +```bash +kurtosis run github.com/YOUR_GITHUB_USERNAME/REPOSITORY_NAME '{"actors": [{"first_name":"Harrison", "last_name": "Ford"} +``` +Where `YOUR_GITHUB_USERNAME` is your Github username, and `REPOSITORY_NAME` is the name of your Github repository that houses your `kurtosis.yml` and `main.star` files. @@ -959,6 +966,7 @@ Thank you for trying our quickstart. We hope you enjoyed it. [cassandra-package-example]: https://github.com/kurtosis-tech/cassandra-package [go-test-example]: https://github.com/kurtosis-tech/awesome-kurtosis/tree/main/quickstart/go-test [ts-test-example]: https://github.com/kurtosis-tech/awesome-kurtosis/tree/main/quickstart/ts-test +[quickstart-consumers]: quickstart.md [homepage]: home.md diff --git a/docs/versioned_docs/version-0.83.10/get-started/quickstart.md b/docs/versioned_docs/version-0.83.10/get-started/quickstart.md new file mode 100644 index 0000000000..023036fdd7 --- /dev/null +++ b/docs/versioned_docs/version-0.83.10/get-started/quickstart.md @@ -0,0 +1,259 @@ +--- +title: Quickstart - Run a Package +sidebar_label: Quickstart - Run a Package +slug: /quickstart +toc_max_heading_level: 2 +sidebar_position: 1 +--- + +Introduction +------------ + +Welcome to the [Kurtosis][homepage] quickstart! This guide takes ~5 minutes and will walk you through how to use a Kurtosis package to spin up a distributed system over Docker. Specifically, you will use the [eth2-package][eth2-package] to bootstrap and start-up a private Ethereum testnet. + +Kurtosis is a composable build system for reproducible test environments and serve two types of users: the author of an environment definition, referred to as a [Kurtosis package][packages-reference], and the consumer or user of the environment definition. This quickstart is intended to put you in the shoes of the consumer - someone who needs a quick and easy way to get a production-like test environment to develop and test changes quicker for your distributed system. A separate guide is [available here][how-to-set-up-postgres-guide] to introduce you to the world of Kurtosis package authoring and how one might define and build an environment with Kurtosis for themselves or for their team. + +Our mission is to make building distributed systems as easy as building a single server application. The first problem we aim to solve on our journey to achieve this mission is to bridge the author-consumer divide for environment definitions. For this reason, we built Kurtosis. Further reading about what Kurtosis is and what problems Kurtosis aims to solve, is available on our [introduction page][homepage]. To learn more about our motivations behind starting Kurtosis, go [here][why-we-built-kurtosis-explanation]. + +This guide is in a "code along" format, which means you are expected to follow the code examples and run the Kurtosis CLI commands on your local machine. Everything you run in this guide is free, public, and does not contain any sensitive data. + +:::tip What You'll Do +1. Install Kurtosis and Docker, if you haven't already. +2. Configure how you want your distributed system to be spun up, using parameters that are passed in at runtime. +3. Run a single command to spin up your network. +::: + +
TL;DR Version + +This quickstart is in a "code along" format. You can also dive straight into running the end results and exploring the code too. + +**Open the Playground: [Start](https://gitpod.io/?autoStart=true&editor=code#https://github.com/kurtosis-tech/eth2-package)** + +Click on the "New Workspace" button! You don't have to worry about the Context URL, Editor or Class. It's all pre-configured for you. + +
+ +If you ever get stuck, every Kurtosis command accepts a `-h` flag to print helptext. If that doesn't help, you can get in touch with us in our [Discord server](https://discord.gg/jJFG7XBqcY) or on [Github](https://github.com/kurtosis-tech/kurtosis/issues/new/choose)! + +Install dependencies +-------------------- +Before you get started, make sure you have: +* [Installed Docker](https://docs.docker.com/get-docker/) and ensure the Docker Daemon is running on your machine (e.g. open Docker Desktop). You can quickly check if Docker is running by running: `docker image ls` from your terminal to see all your Docker images. +* [Installed Kurtosis](https://docs.kurtosis.com/install/#ii-install-the-cli) or [upgrade Kurtosis to the latest version](https://docs.kurtosis.com/upgrade). You can check if Kurtosis is running using the command: `kurtosis version`, which will print your current Kurtosis engine version and CLI version. + +Define how your system should look like +--------------------------------------- + +Kurtosis environment definitions, referred to here on as [Kurtosis packages][packages-reference], support parameterization out of the box. This means your teams or your communities can leverage the same package with different configurations for their specific use-case, eliminating the need to maintain different Bash scripts or `docker-compose.yml` files per use of the environment definition. + +You're now going to create a file to house the parameters that you will pass in at runtime when your system starts up. Check out the README for the [eth2-package][eth2-package] to see the full list of configuration options and flags available for use. + +Create a file titled: `network_params.json` in your home directory, populate it with the below contents, and save your file: +```json +{ + "participants": [{ + "el_client_type": "geth", + "el_client_image": "ethereum/client-go:latest", + "el_client_log_level": "", + "el_extra_params": [], + "cl_client_type": "lighthouse", + "cl_client_image": "sigp/lighthouse:latest", + "cl_client_log_level": "", + "beacon_extra_params": [], + "validator_extra_params": [], + "builder_network_params": null, + "count": 2 + }], + "network_params": { + "network_id": "3151908", + "deposit_contract_address": "0x4242424242424242424242424242424242424242", + "seconds_per_slot": 12, + "slots_per_epoch": 32, + "num_validator_keys_per_node": 64, + "preregistered_validator_keys_mnemonic": "giant issue aisle success illegal bike spike question tent bar rely arctic volcano long crawl hungry vocal artwork sniff fantasy very lucky have athlete", + "deneb_for_epoch": 500 + }, + "verifications_epoch_limit": 5, + "global_client_log_level": "info", + "mev_type": "none", + // When set to true, Kurtosis will bootstrap and start a Grafana and Prometheus instance alongside other network monitoring tools. + "launch_additional_services": false, +} +``` +The arrays in the `participant` object enables you to define the specific Ethereum client types and respective image tags you want to use in your network, alongside any extra parameters for the validator, beacon, or builder as well as some useful flags for the verbosity of log lines. In this example you'll be using the `latest` image tags for the Geth and Lighthouse clients and have specified `2` nodes to be spun up. + +Meanwhile, the `network_params` object defines the specific parameters for the network, including traits like the `network_id`, `seconds_per_slot`, and `slots_per_epoch`. + +Lastly, there are a few fields that let you, as a consumer, define the log verbosity level and whether or not you'd like additional services and infrastructure to be spun up with your distributed system. In this example, you will not spin up extra monitoring tools (via the `launch_additional_service` field) or Proposer-Builder Seperation (PBS) infrastructure (via the `mev_type` field). + +Spin up your system! +-------------------- +Great! You're now ready to bring up your own network. Simply run: +```console +kurtosis run --enclave eth-network github.com/kurtosis-tech/eth2-package "$(cat ~/network_params.json)" +``` + +Kurtosis will then begin to spin up your private Ethereum testnet by interpreting the instructions in the Kurtosis package, validating the plan to ensure there are no conflicts or obvious errors, and then finally executes the plan (read more about multi-phase runs [here][multi-phase-runs-reference]). Kurtosis first spins up an isolated, ephemeral environment on your machine called an [enclave][enclaves-reference] where all the services and [files artifacts][files-artifacts-reference] for your system will reside in. Then, those services will be bootstrapped and required files generated to start up the system. + +You will see a stream of text get printed in your terminal as Kurtosis begins to generate genesis files, configure the Ethereum nodes, launch a Grafana and Prometheus instance, and bootstrap the network together. In ~2 minutes, you should see the following output at the end: + +```console +INFO[2023-08-28T13:05:31-04:00] ==================================================== +INFO[2023-08-28T13:05:31-04:00] || Created enclave: eth-network || +INFO[2023-08-28T13:05:31-04:00] ==================================================== +Name: eth-network +UUID: e1a41707ee8e +Status: RUNNING +Creation Time: Mon, 28 Aug 2023 13:04:53 EDT + +========================================= Files Artifacts ========================================= +UUID Name +a662c7c74685 1-lighthouse-geth-0-63 +6421d80946ce 2-lighthouse-geth-64-127 +a1ad3962f148 cl-genesis-data +730d585d5ec5 el-genesis-data +c1e452ad7e53 genesis-generation-config-cl +284cde692102 genesis-generation-config-el +b03a5b7b9340 geth-prefunded-keys +013f5d8708fa prysm-password + +========================================== User Services ========================================== +UUID Name Ports Status +202516f0ff8f cl-1-lighthouse-geth http: 4000/tcp -> http://127.0.0.1:65191 RUNNING + metrics: 5054/tcp -> http://127.0.0.1:65192 + tcp-discovery: 9000/tcp -> 127.0.0.1:65193 + udp-discovery: 9000/udp -> 127.0.0.1:64174 +66bdfbd6c066 cl-1-lighthouse-geth-validator http: 5042/tcp -> 127.0.0.1:65236 RUNNING + metrics: 5064/tcp -> http://127.0.0.1:65237 +b636913d4d03 cl-2-lighthouse-geth http: 4000/tcp -> http://127.0.0.1:65311 RUNNING + metrics: 5054/tcp -> http://127.0.0.1:65312 + tcp-discovery: 9000/tcp -> 127.0.0.1:65310 + udp-discovery: 9000/udp -> 127.0.0.1:51807 +e296eefa1710 cl-2-lighthouse-geth-validator http: 5042/tcp -> 127.0.0.1:65427 RUNNING + metrics: 5064/tcp -> http://127.0.0.1:65428 +4df1beb0203d el-1-geth-lighthouse engine-rpc: 8551/tcp -> 127.0.0.1:65081 RUNNING + rpc: 8545/tcp -> 127.0.0.1:65079 + tcp-discovery: 30303/tcp -> 127.0.0.1:65078 + udp-discovery: 30303/udp -> 127.0.0.1:55146 + ws: 8546/tcp -> 127.0.0.1:65080 +581a0fe5de77 el-2-geth-lighthouse engine-rpc: 8551/tcp -> 127.0.0.1:65130 RUNNING + rpc: 8545/tcp -> 127.0.0.1:65132 + tcp-discovery: 30303/tcp -> 127.0.0.1:65131 + udp-discovery: 30303/udp -> 127.0.0.1:49475 + ws: 8546/tcp -> 127.0.0.1:65129 +4980884d9bb0 prelaunch-data-generator-cl-genesis-data RUNNING +3174baf6a6ff prelaunch-data-generator-el-genesis-data RUNNING +``` + +Thats it! You now have a full, private Ethereum blockchain on your local machine. + +The first section that gets printed contains some basic metadata about the enclave that was spun up. This includes the name of the enclave `eth-network`, its [Resource Idenfitier](https://docs.kurtosis.com/concepts-reference/resource-identifier/), your enclave's status, and the time it was created. + +Next, you'll see a section dedicated to [Files Artifacts](https://docs.kurtosis.com/concepts-reference/files-artifacts/), which are Kurtosis' first-class representation of data inside your enclave, stored as compressed TGZ files. You'll notice there are configuration files for the nodes, grafana, and prometheus as well as private keys for pre-funded accounts and genesis-related data. These files artifacts were generated and used by Kurtosis to start the network and abstracts away the complexities and overhead that come with generating validator keys and getting genesis and node config files produced and mounted to the right containers yourself. + +Lastly, there is a section called `User Services` which display the number of services (running in Docker containers) that make up your network. You will notice that there are 2 Ethereum nodes comprised of 3 services each (an EL client, a CL beacon client, and a CL validator client) and 2 genesis data generators for each the CL and EL. Each of these services are running in Docker containers inside your local enclave & Kurtosis has automatically mapped each container port to your machine's ephemeral ports for seamless interaction with the services running in your enclave. + +Why Kurtosis packages - from a consumer's perspective +----------------------------------------------------- +Kurtosis was built to make building distributed systems as easy as building a single server app. Kurtosis aims to achieve this by bridging the environment definition author-consumer divide. Tactically, this means making it dead simple for a consumer (like yourself) to pick up an environment definition, spin it up, and deploy it the way you want, where you want - all without needing to know specialized knowledge about how the system works or how to use Kubernetes or Docker. + +Specifically, this guide showed you: +- ***The power of parameterizability***: as a consumer of the environment definition, having both the knowledge and means to configure the system to spin up the way you need it is incredibly valuable - a big reason why Kurtosis packages are meant to be parameterized. In this guide, you created the `network_params.json` file which contained your preferences for how the network should look and passed them in to Kurtosis with relative ease. The author of the package need only define the arguments and flags available for a consumer, and Kurtosis handles the rest once those are passed in at runtime. +- ***Portable and easy to wield***: a major contributor to the author-consumer divide comes from the knowledge gap between the author and consumer regarding the infrastruture and tools needed to instantiate a system. Understanding how Kubernetes works, what Bash script to use at which step, and working with Docker primitivies are all pain points we believe Kurtosis alleviates. In this guide, you installed Kurtosis and ran a single command to get your system up and running. This same command will work anywhere, over Docker or on Kubernetes, locally or on remote infrastructure. We believe this portability and ease of use are requirements for bridging the author-consumer divide. + +There are many other reasons why we believe Kurtosis is the right tool for bridging the author-consumer divide. Check out the [next guide][how-to-set-up-postgres-guide] to experience the workflow for a package author and how Kurtosis improves the developer experience for an environment definition author. + +Conclusion +---------- +And that's it - you've successfully used Kurtosis to instantiate a full, private Ethereum testnet - one of the most complex distributed systems in todays time. + +Let's review. In this tutorial you have: + +1. Installed Kurtosis and Docker. +2. Configure how your system should look like, using parameters that are passed in at runtime. +3. Run a single command to spin up your network. +4. Reviewed how package consumers benefit from using environment definitions written for Kurtosis. + +:::tip +In this short guide, you went through the workflow that a Kurtosis package consumer would experience. It is strongly encouraged that you check out the [next guide][how-to-set-up-postgres-guide] where you will set up a Postgres database and an API server to as a package author. +::: + +This was still just an introduction to Kurtosis. To dig deeper, visit other sections of our docs where you can read about [what Kurtosis is][homepage], understand the [architecture][architecture-explanation], and hear our [inspiration for starting Kurtosis][why-we-built-kurtosis-explanation]. + +To learn more about how Kurtosis is used, we encourage you to check out our [`awesome-kurtosis` repository][awesome-kurtosis-repo], where you will find real-world examples of Kurtosis in action, including: +- How to run a simple [Go test][go-test-example] or [Typescript test][ts-test-example] against the app we just built +- The [Ethereum package][ethereum-package], used by the Ethereum Foundation, which can be used to set up local testnets +- A parameterized package for standing up an [n-node Cassandra cluster with Grafana and Prometheus][cassandra-package-example] out-of-the-box +- The [NEAR package][near-package] for local dApp development in the NEAR ecosystem + +Finally, we'd love to hear from you. Please don't hesitate to share with us what went well, and what didn't, using `kurtosis feedback` to file an issue in our [Github](https://github.com/kurtosis-tech/kurtosis/issues/new/choose) or to [chat with our cofounder, Kevin](https://calendly.com/d/zgt-f2c-66p/kurtosis-onboarding). + +Lastly, feel free to [star us on Github](https://github.com/kurtosis-tech/kurtosis), [join the community in our Discord](https://discord.com/channels/783719264308953108/783719264308953111), and [follow us on Twitter](https://twitter.com/KurtosisTech)! + +Thank you for trying our quickstart. We hope you enjoyed it. + + + + +[installing-kurtosis-guide]: ../guides/installing-the-cli.md +[installing-docker-guide]: ../guides/installing-the-cli.md#i-install--start-docker +[upgrading-kurtosis-guide]: ../guides/upgrading-the-cli.md +[how-to-set-up-postgres-guide]: quickstart-author.md + + +[architecture-explanation]: ../explanations/architecture.md +[enclaves-reference]: ../concepts-reference/enclaves.md +[services-explanation]: ../explanations/architecture.md#services +[reusable-environment-definitions-explanation]: ../explanations/reusable-environment-definitions.md +[why-we-built-kurtosis-explanation]: ../explanations/why-we-built-kurtosis.md +[how-do-imports-work-explanation]: ../explanations/how-do-kurtosis-imports-work.md +[why-multi-phase-runs-explanation]: ../explanations/why-multi-phase-runs.md + + + +[cli-reference]: /cli/ +[kurtosis-run-reference]: ../cli-reference/run.md +[kurtosis-clean-reference]: ../cli-reference/clean.md +[kurtosis-enclave-inspect-reference]: ../cli-reference/enclave-inspect.md +[kurtosis-files-upload-reference]: ../cli-reference/files-upload.md +[kurtosis-feedback-reference]: ../cli-reference/feedback.md +[kurtosis-twitter]: ../cli-reference/twitter.md +[starlark-reference]: ../concepts-reference/starlark.md + + +[request-reference]: ../starlark-reference/plan.md#request +[exec-reference]: ../starlark-reference/plan.md#exec + + +[multi-phase-runs-reference]: ../concepts-reference/multi-phase-runs.md +[kurtosis-yml-reference]: ../concepts-reference/kurtosis-yml.md +[packages-reference]: ../concepts-reference/packages.md +[runnable-packages-reference]: ../concepts-reference/packages.md#runnable-packages +[locators-reference]: ../concepts-reference/locators.md +[plan-reference]: ../concepts-reference/plan.md +[future-references-reference]: ../concepts-reference/future-references.md +[files-artifacts-reference]: ../concepts-reference/files-artifacts.md + + + +[awesome-kurtosis-repo]: https://github.com/kurtosis-tech/awesome-kurtosis +[data-package-example]: https://github.com/kurtosis-tech/awesome-kurtosis/tree/main/data-package +[data-package-example-main.star]: https://github.com/kurtosis-tech/awesome-kurtosis/blob/main/data-package/main.star +[data-package-example-seed-tar]: https://github.com/kurtosis-tech/awesome-kurtosis/blob/main/data-package/dvd-rental-data.tar +[cassandra-package-example]: https://github.com/kurtosis-tech/cassandra-package +[go-test-example]: https://github.com/kurtosis-tech/awesome-kurtosis/tree/main/quickstart/go-test +[ts-test-example]: https://github.com/kurtosis-tech/awesome-kurtosis/tree/main/quickstart/ts-test +[eth2-package]: https://github.com/kurtosis-tech/eth2-package/ + + +[homepage]: home.md +[kurtosis-managed-packages]: https://github.com/kurtosis-tech?q=in%3Aname+package&type=all&language=&sort= +[wild-kurtosis-packages]: https://github.com/search?q=filename%3Akurtosis.yml&type=code +[bazel-github]: https://github.com/bazelbuild/bazel/ +[starlark-github-repo]: https://github.com/bazelbuild/starlark +[postgrest]: https://postgrest.org/en/stable/ +[ethereum-package]: https://github.com/kurtosis-tech/eth2-package +[waku-package]: https://github.com/logos-co/wakurtosis +[near-package]: https://github.com/kurtosis-tech/near-package +[iterm]: https://iterm2.com/ +[vscode-plugin]: https://marketplace.visualstudio.com/items?itemName=Kurtosis.kurtosis-extension diff --git a/docs/versioned_docs/version-0.83.5/guides/adding-command-line-completion.md b/docs/versioned_docs/version-0.83.10/guides/adding-command-line-completion.md similarity index 99% rename from docs/versioned_docs/version-0.83.5/guides/adding-command-line-completion.md rename to docs/versioned_docs/version-0.83.10/guides/adding-command-line-completion.md index 4a28979888..318b116f8d 100644 --- a/docs/versioned_docs/version-0.83.5/guides/adding-command-line-completion.md +++ b/docs/versioned_docs/version-0.83.10/guides/adding-command-line-completion.md @@ -1,7 +1,7 @@ --- title: Adding Command-Line Completion sidebar_label: Adding Command-Line Completion -sidebar_position: 4 +sidebar_position: 3 --- diff --git a/docs/versioned_docs/version-0.83.5/guides/installing-the-cli.md b/docs/versioned_docs/version-0.83.10/guides/installing-the-cli.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/guides/installing-the-cli.md rename to docs/versioned_docs/version-0.83.10/guides/installing-the-cli.md diff --git a/docs/versioned_docs/version-0.83.5/guides/running-in-ci.md b/docs/versioned_docs/version-0.83.10/guides/running-in-ci.md similarity index 99% rename from docs/versioned_docs/version-0.83.5/guides/running-in-ci.md rename to docs/versioned_docs/version-0.83.10/guides/running-in-ci.md index d90069b516..181b4a7923 100644 --- a/docs/versioned_docs/version-0.83.5/guides/running-in-ci.md +++ b/docs/versioned_docs/version-0.83.10/guides/running-in-ci.md @@ -2,6 +2,7 @@ title: Running Kurtosis in CI sidebar_label: Running in CI slug: /ci +sidebar_position: 5 --- Running Kurtosis on your local machine is nice, but executing it as part of CI is even better. This guide will walk you through modifying your CI config file to use Kurtosis in your CI environment: diff --git a/docs/versioned_docs/version-0.83.5/guides/running-in-k8s.md b/docs/versioned_docs/version-0.83.10/guides/running-in-k8s.md similarity index 99% rename from docs/versioned_docs/version-0.83.5/guides/running-in-k8s.md rename to docs/versioned_docs/version-0.83.10/guides/running-in-k8s.md index 25582bebf0..d4e924c063 100644 --- a/docs/versioned_docs/version-0.83.5/guides/running-in-k8s.md +++ b/docs/versioned_docs/version-0.83.10/guides/running-in-k8s.md @@ -2,6 +2,7 @@ title: Running Kurtosis in Kubernetes sidebar_label: Running in Kubernetes slug: /k8s +sidebar_position: 6 --- This guide assumes that you have [Kurtosis installed](./installing-the-cli.md). diff --git a/docs/versioned_docs/version-0.83.5/guides/running-in-kurtosis-cloud.md b/docs/versioned_docs/version-0.83.10/guides/running-in-kurtosis-cloud.md similarity index 99% rename from docs/versioned_docs/version-0.83.5/guides/running-in-kurtosis-cloud.md rename to docs/versioned_docs/version-0.83.10/guides/running-in-kurtosis-cloud.md index 5485abfe73..05c49205dd 100644 --- a/docs/versioned_docs/version-0.83.5/guides/running-in-kurtosis-cloud.md +++ b/docs/versioned_docs/version-0.83.10/guides/running-in-kurtosis-cloud.md @@ -2,6 +2,7 @@ title: Running Kurtosis in Kurtosis Cloud sidebar_label: Running in Kurtosis Cloud slug: /cloud +sidebar_position: 7 --- Kurtosis Cloud is a fully managed cloud offering and accompanying self-service workflows for a stress-free, easy way to deploy test and dev environments, that live as long as you need them to, directly onto remote infrastructure. By logging into our [cloud portal](https://cloud.kurtosis.com), a cloud instance will be provisioned to run your test and dev enclaves. diff --git a/docs/versioned_docs/version-0.83.5/guides/upgrading-the-cli.md b/docs/versioned_docs/version-0.83.10/guides/upgrading-the-cli.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/guides/upgrading-the-cli.md rename to docs/versioned_docs/version-0.83.10/guides/upgrading-the-cli.md diff --git a/docs/versioned_docs/version-0.83.5/roadmap.md b/docs/versioned_docs/version-0.83.10/roadmap.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/roadmap.md rename to docs/versioned_docs/version-0.83.10/roadmap.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/directory.md b/docs/versioned_docs/version-0.83.10/starlark-reference/directory.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/directory.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/directory.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/exec-recipe.md b/docs/versioned_docs/version-0.83.10/starlark-reference/exec-recipe.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/exec-recipe.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/exec-recipe.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/get-http-request-recipe.md b/docs/versioned_docs/version-0.83.10/starlark-reference/get-http-request-recipe.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/get-http-request-recipe.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/get-http-request-recipe.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/import-module.md b/docs/versioned_docs/version-0.83.10/starlark-reference/import-module.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/import-module.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/import-module.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/index.md b/docs/versioned_docs/version-0.83.10/starlark-reference/index.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/index.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/index.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/plan.md b/docs/versioned_docs/version-0.83.10/starlark-reference/plan.md similarity index 97% rename from docs/versioned_docs/version-0.83.5/starlark-reference/plan.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/plan.md index d97be9f8f7..514c9b253b 100644 --- a/docs/versioned_docs/version-0.83.5/starlark-reference/plan.md +++ b/docs/versioned_docs/version-0.83.10/starlark-reference/plan.md @@ -221,6 +221,17 @@ render_templates The `render_templates` instruction combines a template and data to produce a [files artifact][files-artifacts-reference]. Files artifacts can be used with the `files` property of the `ServiceConfig` object, allowing for reuse of config files across services. +**Returns**: a [future reference][future-references-reference] resolving to a `string` representing the name of a [files artifact][files-artifacts-reference]. + +**Args**: +- `config`: a dictionary with the following keys and values: + - **keys**: `string`s representing the filepaths to be produced within the returned files artifact + - **values**: `struct`s with the following root level keys: + - `template`: a string with representing the template in [Go template format](https://pkg.go.dev/text/template#pkg-overview) + - `data`: a `struct` or `dict` type, with keys matching the variables used in the template, and values matching the intended replacement values. + +**Examples**: + ```python # Example data to slot into the template template_data = { @@ -259,7 +270,10 @@ artifact_name = plan.render_templates( ) ``` -The return value is a [future reference][future-references-reference] to the name of the [files artifact][files-artifacts-reference] that was generated, which can be used with the `files` property of the service config of the `add_service` command. +**See also**: +- [add-service] +- [add-services] +- [service-config] request ------- diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/port-spec.md b/docs/versioned_docs/version-0.83.10/starlark-reference/port-spec.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/port-spec.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/port-spec.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/post-http-request-recipe.md b/docs/versioned_docs/version-0.83.10/starlark-reference/post-http-request-recipe.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/post-http-request-recipe.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/post-http-request-recipe.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/read-file.md b/docs/versioned_docs/version-0.83.10/starlark-reference/read-file.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/read-file.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/read-file.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/ready-condition.md b/docs/versioned_docs/version-0.83.10/starlark-reference/ready-condition.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/ready-condition.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/ready-condition.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/service-config.md b/docs/versioned_docs/version-0.83.10/starlark-reference/service-config.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/service-config.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/service-config.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/service.md b/docs/versioned_docs/version-0.83.10/starlark-reference/service.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/service.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/service.md diff --git a/docs/versioned_docs/version-0.83.5/starlark-reference/standard-library.md b/docs/versioned_docs/version-0.83.10/starlark-reference/standard-library.md similarity index 100% rename from docs/versioned_docs/version-0.83.5/starlark-reference/standard-library.md rename to docs/versioned_docs/version-0.83.10/starlark-reference/standard-library.md diff --git a/docs/versioned_docs/version-0.83.5/get-started/home.md b/docs/versioned_docs/version-0.83.5/get-started/home.md deleted file mode 100644 index 51bb62eee2..0000000000 --- a/docs/versioned_docs/version-0.83.5/get-started/home.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Introduction -sidebar_label: Introduction -slug: '/' -sidebar_position: 1 -hide_table_of_contents: true ---- -## What is Kurtosis? -[Kurtosis](https://www.kurtosis.com) is a composable build system for multi-container test environments. Kurtosis makes it easier for developers to set up test environments that require dynamic setup logic (e.g. passing IPs or runtime-generated data between services) or programmatic data seeding. - -Go [here](../explanations/why-we-built-kurtosis.md) to learn more about what inspired us to build Kurtosis. - -## Why use Kurtosis? - -Developers usually set up these types of dynamic environments with a free-form scripting language like bash or Python, interacting with the Docker CLI or Docker Compose. Kurtosis is designed to make these setups easier to maintain and reuse in different test scenarios. - -In Kurtosis, test environments have these properties: -- Environment-level portability: the entire test environment always runs the same way, regardless of the host machine -- Composability: environments can be composed and connected together without needing to know the inner details of each setup -- Parameterizability: environments can be parameterized, so that they're easy to modify for use across different test scenarios - -## Architecture - -#### Kurtosis has a definition language of: -- An instruction set of useful primitives for setting up and manipulating environments -- A scriptable Python-like SDK in Starlark, a build language used by Google’s Bazel -- A package management system for shareability and composability - -#### Kurtosis has a validator with: -- Compile-time safety to quickly catch errors in test environment definitions -- The ability to dry-run test environment definitions to verify what will be run, before running - -#### Kurtosis has a runtime to: -- Run multi-container test environments over Docker or Kubernetes, depending on how you wish to scale -- Enable debugging and investigation of problems live, as they're happening in your test environment -- Manage file dependencies to ensure complete portability of test environments across different test runs and backends - -## Try out Kurtosis now - -Try Kurtosis now with our [quickstart](./quickstart.md). - -:::info -If you have questions, need help, or simply want to learn more, schedule a live session with us, go [here](https://calendly.com/d/zgt-f2c-66p/kurtosis-onboarding). -::: diff --git a/docs/versioned_sidebars/version-0.83.5-sidebars.json b/docs/versioned_sidebars/version-0.83.10-sidebars.json similarity index 100% rename from docs/versioned_sidebars/version-0.83.5-sidebars.json rename to docs/versioned_sidebars/version-0.83.10-sidebars.json diff --git a/docs/versions.json b/docs/versions.json index 0ba5ba5253..5e29565d66 100644 --- a/docs/versions.json +++ b/docs/versions.json @@ -1,9 +1,9 @@ [ + "0.83.10", "0.83.9", "0.83.8", "0.83.7", "0.83.6", - "0.83.5", "0.82.24", "0.81.9", "0.80.24", diff --git a/version.txt b/version.txt index 56549a4271..88c61fe269 100644 --- a/version.txt +++ b/version.txt @@ -1 +1 @@ -0.83.9 +0.83.10