chore(main): release 0.73.1 (#419)

🤖 I have created a release *beep* *boop*
---


##
[0.73.1](0.73.0...0.73.1)
(2023-04-02)


### Features

* Reduce the word count & language complexity of the Github Issue
templates ([#437](#437))
([b1fad7d](b1fad7d))


### Bug Fixes

* Fix links that should be absolute
([#427](#427))
([492bea6](492bea6))
* Fixed many broken links in the docs
([#444](#444))
([9251cc9](9251cc9))
* Improve error message when package arg fails deserialisation
([#418](#418))
([d54fd73](d54fd73))
* Indent Caused by in stacktraces
([#417](#417))
([c165a15](c165a15))
* Try and fix Yarn lockfile violation that's causing Cloudflare publish
to fail ([#445](#445))
([4db878b](4db878b))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.73.1](https://github.com/kurtosis-tech/kurtosis/compare/0.73.0...0.73.1) (2023-04-02)
+
+
+### Features
+
+* Reduce the word count & language complexity of the Github Issue templates ([#437](https://github.com/kurtosis-tech/kurtosis/issues/437)) ([b1fad7d](https://github.com/kurtosis-tech/kurtosis/commit/b1fad7d9207be855fbdbce9d70410aecf679d892))
+
+
+### Bug Fixes
+
+* Actually fix the broken Docusaurus links in the navbar and footer ([#450](https://github.com/kurtosis-tech/kurtosis/issues/450)) ([3436445](https://github.com/kurtosis-tech/kurtosis/commit/3436445f3f6351b66c9ef5d86a59accd19f4baaf))
+* Fix bug with release-please PR getting a modified Yarn lockfile ([#446](https://github.com/kurtosis-tech/kurtosis/issues/446)) ([bfa155b](https://github.com/kurtosis-tech/kurtosis/commit/bfa155bf4d4be19cff1f3635083d6390586b94fa))
+* Fix links that should be absolute ([#427](https://github.com/kurtosis-tech/kurtosis/issues/427)) ([492bea6](https://github.com/kurtosis-tech/kurtosis/commit/492bea61723b03377c1b981c946fd3fd1c83c70e))
+* Fixed many broken links in the docs ([#444](https://github.com/kurtosis-tech/kurtosis/issues/444)) ([9251cc9](https://github.com/kurtosis-tech/kurtosis/commit/9251cc9f49a323c8916112decc9cd9d9e1fcc430))
+* Improve error message when package arg fails deserialisation ([#418](https://github.com/kurtosis-tech/kurtosis/issues/418)) ([d54fd73](https://github.com/kurtosis-tech/kurtosis/commit/d54fd73e0cb3713214549d6d20f04d374d8bbb50))
+* Indent Caused by in stacktraces ([#417](https://github.com/kurtosis-tech/kurtosis/issues/417)) ([c165a15](https://github.com/kurtosis-tech/kurtosis/commit/c165a15ca24e5af523e27c2d34661025e4189590))
+* Remove no-dead-links Remark plugin ([#447](https://github.com/kurtosis-tech/kurtosis/issues/447)) ([b59b3f8](https://github.com/kurtosis-tech/kurtosis/commit/b59b3f8fd07fe3789595b580085841df54990b57))
+* Remove Quickstart, SDK, and CLI links from the navbar ([#449](https://github.com/kurtosis-tech/kurtosis/issues/449)) ([a7effc9](https://github.com/kurtosis-tech/kurtosis/commit/a7effc946c5db2eeacbcbaee4286c85989a7005f))
+* Try and fix Yarn lockfile violation that's causing Cloudflare publish to fail ([#445](https://github.com/kurtosis-tech/kurtosis/issues/445)) ([4db878b](https://github.com/kurtosis-tech/kurtosis/commit/4db878ba1c47e55af92206249775b573b8de7fd0))
+
 ## [0.73.0](https://github.com/kurtosis-tech/kurtosis/compare/0.72.2...0.73.0) (2023-03-31)
 
 

LICENSE.md

@@ -3,7 +3,7 @@ Business Source License 1.1
 Parameters
 
 Licensor:             Kurtosis Technologies, Inc.
-Licensed Work:        Kurtosis 0.73.0
+Licensed Work:        Kurtosis 0.73.1
 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-03-31
+Change Date:          2027-04-02
 
 Change License:       AGPLv3 (GNU Affero General Public License Version 3)
 

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.73.0"
+	KurtosisVersion = "0.73.1"
 	// !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!!
 )

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.73.0",
+    "version": "0.73.1",
     "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",

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.73.0"
+export const KURTOSIS_VERSION: string = "0.73.1"
 // !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!!

docs/versioned_docs/version-0.73.1/cli-reference/analytics-disable.md

@@ -0,0 +1,13 @@
+---
+title: analytics disable
+sidebar_label: analytics disable
+slug: /analytics-disable
+---
+
+Kurtosis has functionality to collect product analytics metrics so we can make data-driven product decisions. These metrics are [anonymized, obfuscated, and never given to third parties](../explanations/metrics-philosophy.md)).
+
+Anonymous metrics collection is enabled by default, but you can turn it off by running:
+
+```bash
+kurtosis analytics disable
+``` 

docs/versioned_docs/version-0.73.1/cli-reference/analytics-enable.md

@@ -0,0 +1,13 @@
+---
+title: analytics enable
+sidebar_label: analytics enable
+slug: /analytics-enable
+---
+
+Kurtosis has functionality to collect product analytics metrics so we can make data-driven product decisions. These metrics are [anonymized, obfuscated, and never given to third parties](../explanations/metrics-philosophy.md)).
+
+If you previously disabled metrics collection, you can re-enable it via:
+
+```bash
+kurtosis analytics enable
+``` 

docs/versioned_docs/version-0.73.1/cli-reference/analytics-id.md

@@ -0,0 +1,15 @@
+---
+title: analytics id
+sidebar_label: analytics id
+slug: /analytics-id
+---
+
+In addition to log outputs and screenshots, [product analytics metrics](../explanations/metrics-philosophy.md) may be useful for our team when debugging issues and shipping fixes for bugs. 
+
+If you so choose, you may share with us your metrics user ID when letting us know about issues or bugs (in our [Github](https://github.com/kurtosis-tech/kurtosis/issues/new/choose) or on [Discord](https://discord.gg/rjkj8m5C)). Doing helps us debug issues, ship fixes quicker, and ultimately improve Kurtosis over time.
+
+To print your metrics user ID, simply run:
+
+```bash
+kurtosis analytics id
+``` 

docs/versioned_docs/version-0.73.1/cli-reference/clean.md

@@ -0,0 +1,18 @@
+---
+title: clean
+sidebar_label: clean
+slug: /clean
+---
+
+```console
+Removes stopped enclaves (and live ones if the 'all' flag is set), as well as stopped engine containers
+
+Usage:
+  kurtosis clean [flags]
+
+Flags:
+  -a, --all    If set, removes running enclaves as well
+  -h, --help   help for clean
+```
+
+NOTE: This will not stop the Kurtosis engine itself! To do so, use the [engine stop](./engine-stop.md) command.

docs/versioned_docs/version-0.73.1/cli-reference/completion.md

@@ -0,0 +1,20 @@
+---
+title: completion
+sidebar_label: completion
+slug: /completion
+---
+
+Scripts used to create command-line completion for `bash`, `fish`, `powershell`, and `zsh` can be printed using:
+
+```bash
+kurtosis completion [command]
+```
+
+The available commands are as follows:
+
+* `bash`: Generates the autocompletion script for bash
+* `fish`: Generates the autocompletion script for fish
+* `powershell`: Generates the autocompletion script for powershell
+* `zsh`: Generates the autocompletion script for zsh
+
+Instructions for how to install command-line completion on your shell can be found [here](../guides/adding-command-line-completion.md) in our Guides section.

docs/versioned_docs/version-0.73.1/cli-reference/config-path.md

@@ -0,0 +1,7 @@
+---
+title: config path
+sidebar_label: config path
+slug: /config-path
+---
+
+The `kurtosis config path` command displays the path to the Kurtosis CLI config YAML file. This file is used to configure Kurtosis CLI behaviour.

docs/versioned_docs/version-0.73.1/cli-reference/discord.md

@@ -0,0 +1,11 @@
+---
+title: discord
+sidebar_label: discord
+slug: /discord
+---
+
+The following command can be used to open our Discord server from the CLI where you can join our Discord to ask questions, chat with our team, and meet the community:
+
+```bash
+kurtosis discord
+```

docs/versioned_docs/version-0.73.1/cli-reference/docs.md

@@ -0,0 +1,13 @@
+---
+title: docs
+sidebar_label: docs
+slug: /docs
+---
+
+To open our documentation in the browser from the CLI, run:
+
+```bash
+kurtosis docs
+```
+
+where you can learn more about Kurtosis' architecture, APIs, Starlark, and much more.

docs/versioned_docs/version-0.73.1/cli-reference/dump.md

@@ -0,0 +1,17 @@
+---
+title: dump
+sidebar_label: dump
+slug: /dump
+---
+
+You might need to store the entire state of Kurtosis to disk at some point. You may want to have a log package if your CI fails, or you want to send debugging information to [the author of a Kurtosis package][packages-reference]. Whatever the case may be, you can run:
+
+```bash
+kurtosis dump $OUTPUT_DIRECTORY
+```
+You will get the container logs & configuration in the output directory for further analysis & sharing. This would contain all engines & enclaves.
+
+If you don't specify the `$OUTPUT_DIRECTORY` Kurtosis will dump it to a directory with a name following the schema `kurtosis-dump--TIMESTAMP`.
+
+<!-------------------- ONLY LINKS BELOW THIS POINT ----------------------->
+[packages-reference]: ../concepts-reference/packages.md

docs/versioned_docs/version-0.73.1/cli-reference/enclave-add.md

@@ -0,0 +1,17 @@
+---
+title: enclave add
+sidebar_label: enclave add
+slug: /enclave-add
+---
+
+Your distributed applications run in [enclaves][enclaves-reference]. They are isolated from each other, to ensure they don't interfere with each other. To create a new, empty enclave, simply run:
+
+```bash
+kurtosis enclave add
+```
+
+To create enclaves that support [subnetworks][subnetworks] use the `--with-subnetworks` flag.
+
+<!-------------------- ONLY LINKS BELOW THIS POINT ----------------------->
+[enclaves-reference]: ../concepts-reference/enclaves.md
+[subnetworks]: ../concepts-reference/subnetworks.md

docs/versioned_docs/version-0.73.1/cli-reference/enclave-dump.md

@@ -0,0 +1,20 @@
+---
+title: enclave dump
+sidebar_label: enclave dump
+slug: /enclave-dump
+---
+
+You will likely need to store enclave logs to disk at some point. You may want to have a log package if your CI fails, or you want to send debugging information to [the author of a Kurtosis package][packages-reference]. Whatever the case may be, you can run:
+
+```bash
+kurtosis enclave dump $THE_ENCLAVE_IDENTIFIER $OUTPUT_DIRECTORY
+```
+where the `$THE_ENCLAVE_IDENTIFIER` is the [resource identifier](../concepts-reference/resource-identifier.md) for an enclave.
+
+You will get the container logs & configuration in the output directory for further analysis & sharing.
+
+If you don't specify the `$OUTPUT_DIRECTORY` Kurtosis will dump it to a directory with a name following the `ENCLAVE_NAME--ENCLAVE_UUID` scheme in the
+current working directory.
+
+<!-------------------- ONLY LINKS BELOW THIS POINT ----------------------->
+[packages-reference]: ../concepts-reference/packages.md

docs/versioned_docs/version-0.73.1/cli-reference/enclave-inspect.md

@@ -0,0 +1,23 @@
+---
+title: enclave inspect
+sidebar_label: enclave inspect
+slug: /enclave-inspect
+---
+
+To view detailed information about a given enclave, including its status and contents, run:
+
+```bash
+kurtosis enclave inspect $THE_ENCLAVE_IDENTIFIER 
+```
+
+where `$THE_ENCLAVE_IDENTIFIER` is the [resource identifier](../concepts-reference/resource-identifier.md) for the enclave.
+
+Running the above command will print detailed information about:
+
+- The enclave's status (running or stopped)
+- The services inside the enclave (if any), their status, and the information for accessing those services' ports from your local machine
+- Any files artifacts registered within the specified enclave
+
+By default, UUIDs are shortened. To view the full UUIDs of your resources, add the following flag:
+* `--full-uuids`
+

docs/versioned_docs/version-0.73.1/cli-reference/enclave-ls.md

@@ -0,0 +1,13 @@
+---
+title: enclave ls
+sidebar_label: enclave ls
+slug: /enclave-ls
+---
+
+To print all enclaves (both stopped and running) inside of your Kurtosis engine, use:
+
+```bash
+kurtosis enclave ls
+```
+
+The enclave UUIDs and names that are printed will be used in enclave manipulation commands and are refered to as [resource identifiers](../concepts-reference/resource-identifier.md).

docs/versioned_docs/version-0.73.1/cli-reference/enclave-rm.md

@@ -0,0 +1,14 @@
+---
+title: enclave rm
+sidebar_label: enclave rm
+slug: /enclave-rm
+---
+
+To remove an enclave and all resources associated with that particular enclave, use:
+
+```bash
+kurtosis enclave rm $THE_ENCLAVE_IDENTIFIER 
+```
+where `$THE_ENCLAVE_IDENTIFIER` is the enclave [identifier](../concepts-reference/resource-identifier.md).
+
+Note that this command will only remove stopped enclaves. To destroy a running enclave, pass the `-f`/`--force` flag.

docs/versioned_docs/version-0.73.1/cli-reference/enclave-stop.md

@@ -0,0 +1,16 @@
+---
+title: enclave stop
+sidebar_label: enclave stop
+slug: /enclave-stop
+---
+
+To stop a particular enclave, use:
+
+```bash
+kurtosis enclave stop $THE_ENCLAVE_IDENTIFIER 
+```
+where `$THE_ENCLAVE_IDENTIFIER` is the enclave [identifier](../concepts-reference/resource-identifier.md).
+
+:::caution
+Enclaves that have been stopped cannot currently be restarted. The Kurtosis team is actively working on enabling this functionality.
+:::

docs/versioned_docs/version-0.73.1/cli-reference/engine-logs.md

@@ -0,0 +1,13 @@
+---
+title: engine logs
+sidebar_label: engine logs
+slug: /engine-logs
+---
+
+To get logs for all existing (stopped or running) engines, use:
+
+```bash
+kurtosis engine logs $OUTPUT_DIRECTORY
+```
+
+which will dump all the logs of the engine container to the directory specified by `$OUTPUT_DIRECTORY`. If a `$OUTPUT_DIRECTORY` is not specified, Kurtosis will default to writing the logs in a folder name following the schema `kurtosis-engine-logs--TIMESTAMP` in the working directory.

docs/versioned_docs/version-0.73.1/cli-reference/engine-restart.md

@@ -0,0 +1,11 @@
+---
+title: engine restart
+sidebar_label: engine restart
+slug: /engine-restart
+---
+
+The CLI interacts with the Kurtosis engine, which is a very lightweight container. The CLI will start the engine container automatically for you and you should never need to start it manually, but you might need to restart the engine after a CLI upgrade. To do so, run:
+
+```bash
+kurtosis engine restart
+```

docs/versioned_docs/version-0.73.1/cli-reference/engine-start.md

@@ -0,0 +1,16 @@
+---
+title: engine start
+sidebar_label: engine start
+slug: /engine-start
+---
+
+The Kurtosis engine starts automatically when you run any command that interacts with the engine, such as [`kurtosis enclave add`](./enclave-add.md), but there may be times where the engine has been stopped and you may need to start it again (e.g. starting the engine on a specific version). To do so, run:
+
+```bash
+kurtosis engine start
+```
+This command will do nothing if the Kurtosis engine is already running.
+
+You may optionally pass in the following flags with this command:
+* `--log-level`: The level that the started engine should log at. Options include: `panic`, `fatal`, `error`, `warning`, `info`, `debug`, or `trace`. The engine logs at the `info` level by default.
+* `--version`: The version (Docker tag) of the Kurtosis engine that should be started. If not set, the engine will start up with the default version.

docs/versioned_docs/version-0.73.1/cli-reference/engine-status.md

@@ -0,0 +1,11 @@
+---
+title: engine status
+sidebar_label: engine status
+slug: /engine-status
+---
+
+The engine's version and status can be printed with:
+
+```bash
+kurtosis engine status
+```

docs/versioned_docs/version-0.73.1/cli-reference/engine-stop.md

@@ -0,0 +1,13 @@
+---
+title: engine stop
+sidebar_label: engine stop
+slug: /engine-stop
+---
+
+To stop the engine, run:
+
+```bash
+kurtosis engine stop
+```
+
+Note that this will do nothing if there is no engine running.