GITBOOK-127: change request with no subject merged in GitBook

Author: joshiste

.gitbook/assets/discovery-kit (1).png

@@ -1,77 +1,79 @@
 # Table of contents
 
-- [Welcome to Steadybit](README.md)
+* [Welcome to Steadybit](README.md)
 
 ## Quick Start
 
-- [First Steps](quick-start/getting-started.md)
-- [Install Agents](quick-start/set-up-agents.md)
-- [Run an Experiment](quick-start/run-experiment.md)
-- [Deploy Example Application](quick-start/deploy-example-application.md)
+* [First Steps](quick-start/getting-started.md)
+* [Install Agents](quick-start/set-up-agents.md)
+* [Run an Experiment](quick-start/run-experiment.md)
+* [Deploy Example Application](quick-start/deploy-example-application.md)
 
 ## Concepts
-- [Actions](concepts/actions/README.md)
-- [Discovery](concepts/discovery/README.md)
-- [Query Language](concepts/query-language/README.md)
+
+* [Actions](concepts/actions/README.md)
+* [Discovery](concepts/discovery/README.md)
+* [Query Language](concepts/query-language/README.md)
 
 ## Install and Configure
 
-- [Install Agent](install-and-configure/install-agent/README.md)
-  - [Architecture](install-and-configure/install-agent/agent-architecture.md)
-  - [Install on Kubernetes](install-and-configure/install-agent/install-on-kubernetes.md)
-  - [Install on Linux Hosts](install-and-configure/install-agent/install-on-linux-hosts.md)
-  - [Install using Docker Compose](install-and-configure/install-agent/install-as-docker-container.md)
-  - [Install on Amazon ECS](install-and-configure/install-agent/aws-ecs-ec2.md)
-  - [Extension Discovery](install-and-configure/install-agent/extension-discovery.md)
-  - [Using Mutual TLS for Extensions](install-and-configure/install-agent/using-mutual-tls-for-extensions.md)
-  - [Configuration Options](install-and-configure/install-agent/advanced-configuration.md)
-- [Install On-Prem Platform](install-and-configure/install-on-prem-platform/README.md)
-  - [Install on Kubernetes](install-and-configure/install-on-prem-platform/k8s.md)
-  - [Advanced Agent Authentication](install-and-configure/install-on-prem-platform/advanced-agent-authentication.md)
-  - [Configuration Options](install-and-configure/install-on-prem-platform/advanced-configuration.md)
-  - [Maintenance & Incident Support](install-and-configure/install-on-prem-platform/maintenance-and-incident-support.md)
-- [Manage Environments](install-and-configure/manage-environments/README.md)
-- [Manage Teams and Users](install-and-configure/manage-teams-and-users/README.md)
-  - [Users](install-and-configure/manage-teams-and-users/users.md)
-  - [Teams](install-and-configure/manage-teams-and-users/teams.md)
-  - [Permissions](install-and-configure/manage-teams-and-users/permissions.md)
+* [Install Agent](install-and-configure/install-agent/README.md)
+  * [Architecture](install-and-configure/install-agent/agent-architecture.md)
+  * [Install on Kubernetes](install-and-configure/install-agent/install-on-kubernetes.md)
+  * [Install on Linux Hosts](install-and-configure/install-agent/install-on-linux-hosts.md)
+  * [Install using Docker Compose](install-and-configure/install-agent/install-as-docker-container.md)
+  * [Install on Amazon ECS](install-and-configure/install-agent/aws-ecs-ec2.md)
+  * [Extension Discovery](install-and-configure/install-agent/extension-discovery.md)
+  * [Using Mutual TLS for Extensions](install-and-configure/install-agent/using-mutual-tls-for-extensions.md)
+  * [Configuration Options](install-and-configure/install-agent/advanced-configuration.md)
+* [Install On-Prem Platform](install-and-configure/install-on-prem-platform/README.md)
+  * [Install on Kubernetes](install-and-configure/install-on-prem-platform/k8s.md)
+  * [Advanced Agent Authentication](install-and-configure/install-on-prem-platform/advanced-agent-authentication.md)
+  * [Configuration Options](install-and-configure/install-on-prem-platform/advanced-configuration.md)
+  * [Maintenance & Incident Support](install-and-configure/install-on-prem-platform/maintenance-and-incident-support.md)
+* [Manage Environments](install-and-configure/manage-environments/README.md)
+* [Manage Teams and Users](install-and-configure/manage-teams-and-users/README.md)
+  * [Users](install-and-configure/manage-teams-and-users/users.md)
+  * [Teams](install-and-configure/manage-teams-and-users/teams.md)
+  * [Permissions](install-and-configure/manage-teams-and-users/permissions.md)
 
 ## Use Steadybit
 
-- [Experiments](use-steadybit/experiments/README.md)
-  - [Design](use-steadybit/experiments/design.md)
-  - [Run](use-steadybit/experiments/run.md)
-  - [Emergency Stop](use-steadybit/experiments/emergencyStop.md)
-  - [Share](use-steadybit/experiments/share.md)
-    - [Duplicate](use-steadybit/experiments/duplicate-experiment/README.md)
-    - [YML Import / Export](use-steadybit/experiments/yml-import-export/README.md)
-  - [Schedule](use-steadybit/experiments/schedule.md)
-  - [OpenTelemetry Integration](use-steadybit/experiments/opentelemetry-integration.md)
-- [Explorer](use-steadybit/explorer/README.md)
-  - [Targets](use-steadybit/explorer/targets.md)
-  - [Landscape](use-steadybit/explorer/landscape.md)
-- [Weakspots](use-steadybit/weakspots/README.md)
+* [Experiments](use-steadybit/experiments/README.md)
+  * [Design](use-steadybit/experiments/design.md)
+  * [Run](use-steadybit/experiments/run.md)
+  * [Emergency Stop](use-steadybit/experiments/emergencyStop.md)
+  * [Share](use-steadybit/experiments/share.md)
+    * [Duplicate](use-steadybit/experiments/duplicate-experiment/README.md)
+    * [YML Import / Export](use-steadybit/experiments/yml-import-export/README.md)
+  * [Schedule](use-steadybit/experiments/schedule.md)
+  * [OpenTelemetry Integration](use-steadybit/experiments/opentelemetry-integration.md)
+* [Explorer](use-steadybit/explorer/README.md)
+  * [Targets](use-steadybit/explorer/targets.md)
+  * [Landscape](use-steadybit/explorer/landscape.md)
+* [Weakspots](use-steadybit/weakspots/README.md)
 
 ## Integrate with Steadybit
 
-- [Extensions](integrate-with-steadybit/extensions/README.md)
-  - [Anatomy of an Extension](integrate-with-steadybit/extensions/anatomy-of-an-extension.md)
-  - [Available Extensions](integrate-with-steadybit/extensions/available-extensions.md)
-  - [Extension Installation](integrate-with-steadybit/extensions/extension-installation.md)
-  - [Extension Kits](integrate-with-steadybit/extensions/extension-kits.md)
-- [API](integrate-with-steadybit/api.md)
-  - [Interactive API Documentation](https://platform.steadybit.com/api/swagger)
-- [CLI](integrate-with-steadybit/cli.md)
-- [Badges](integrate-with-steadybit/badges.md)
-- [Webhooks](integrate-with-steadybit/webhooks/README.md)
-  - [Custom Webhooks](integrate-with-steadybit/webhooks/custom-webhooks.md)
-  - [Preflight Webhooks](integrate-with-steadybit/webhooks/preflight-webhooks.md)
-- [Slack Notifications](integrate-with-steadybit/slack-notifications.md)
-- [Audit Log](integrate-with-steadybit/audit-log.md)
+* [Extensions](integrate-with-steadybit/extensions/README.md)
+  * [Anatomy of an Extension](integrate-with-steadybit/extensions/anatomy-of-an-extension.md)
+  * [Available Extensions](integrate-with-steadybit/extensions/available-extensions.md)
+  * [Extension Installation](integrate-with-steadybit/extensions/extension-installation.md)
+  * [Extension Kits](integrate-with-steadybit/extensions/extension-kits.md)
+* [API](integrate-with-steadybit/api.md)
+  * [Interactive API Documentation](https://platform.steadybit.com/api/swagger)
+* [CLI](integrate-with-steadybit/cli.md)
+* [Badges](integrate-with-steadybit/badges.md)
+* [Webhooks](integrate-with-steadybit/webhooks/README.md)
+  * [Custom Webhooks](integrate-with-steadybit/webhooks/custom-webhooks.md)
+  * [Preflight Webhooks](integrate-with-steadybit/webhooks/preflight-webhooks.md)
+* [Slack Notifications](integrate-with-steadybit/slack-notifications.md)
+* [Audit Log](integrate-with-steadybit/audit-log.md)
 
 ## Troubleshooting
 
-- [Overview](troubleshooting/README.md)
-- [Extension](troubleshooting/extension.md)
-- [Agent](troubleshooting/agent.md)
-- [On-Prem Platform](troubleshooting/on-prem-platform.md)
+* [Overview](troubleshooting/README.md)
+* [Extension](troubleshooting/extension.md)
+* [Agent](troubleshooting/agent.md)
+* [Migrating From the Outpost Agent](troubleshooting/migrating-from-the-outpost-agent.md)
+* [On-Prem Platform](troubleshooting/on-prem-platform.md)

.gitbook/assets/widget (1).png

@@ -17,7 +17,7 @@ You can learn more about ActionKit through its [GitHub repository](https://githu
 
 ## DiscoveryKit
 
-<figure><img src="../../.gitbook/assets/discovery-kit.png" alt="DiscoveryKit logo depicting the text discovery kit and a radar dish icon"><figcaption><p>DiscoveryKit logo depicting the text discovery kit and a radar dish icon</p></figcaption></figure>
+<figure><img src="../../.gitbook/assets/discovery-kit (1).png" alt="DiscoveryKit logo depicting the text discovery kit and a radar dish icon"><figcaption><p>DiscoveryKit logo depicting the text discovery kit and a radar dish icon</p></figcaption></figure>
 
 The Steadybit DiscoveryKit enables the extension of Steadybit with new discovery capabilities. For example, DiscoveryKit can be used to author open/closed source discoveries for:
 

SUMMARY.md

@@ -24,25 +24,25 @@ To do that, we start by creating a new experiment via our Wizard, which guides u
 
 First step is to give our experiment a meaningful name and define the environment where to be executed. We choose the `Online Shop DEV` environment to get access to everything Steadybit has discovered for our demo online shop.
 
-![Create experiment step 2](<run-experiment-step2.png>)
+![Create experiment step 2](<run-experiment-step2 (2).png>)
 
 ### Step 3 - Select Attack
 
 Going to the next step, we can choose the attack. We want to simulate unavailability of the `hot-deals` container by isolating it from others. Therefore, we choose the attack "blackhole" on network level.
 
-![Create experiment step 3](<run-experiment-step3.png>)
+![Create experiment step 3](<run-experiment-step3 (2).png>)
 
 ### Step 4 - Select Targets
 
 In the next step we can define our target. Since our target of our experiment is a container running in Kubernetes, we select Container by the attribute `k8s.container.name`. Doing that, our experiment will be reusable even after container restarts.
 
-![Create experiment step 4](<run-experiment-step4.png>)
+![Create experiment step 4](<run-experiment-step4 (2).png>)
 
 ### Step 5 - Set Impact and Attack Radius
 
 Last but not least: We can define how large our impact is. When having a scaled system you may want to start with a small attack radius first - affecting only one container and not all replicas.
 
-![Create experiment step 5](<run-experiment-step5.png>)
+![Create experiment step 5](<run-experiment-step5 (3).png>)
 
 ### Step 6 - Save Experiment
 
@@ -58,7 +58,7 @@ Before running the experiment make sure to have the `/products`-endpoint open in
 
 When hitting the "run experiment"-button you see the Steadybit run window.
 
-![Run experiment - run window](<run-experiment-run2.png>)
+![Run experiment - run window](<run-experiment-run2 (8).png>)
 
 You should notice that the `/products`-endpoint will not work while `hot-deals` is unavailable. This is not desirable as there are other products which could have been browsed by the customers of the online shop. You can improve this behavior by adding appropriate fallbacks or scaling the services.
 

integrate-with-steadybit/extensions/extension-kits.md

@@ -0,0 +1,34 @@
+# Migrating From the Outpost Agent
+
+## Helm Chart
+
+We replaced the `steadybit-outpost` chart with the `steadybit-agent` chart. While the charts are structurally the same, this is not a drop-in replacement, as some defaults and prefixes change:
+
+* The default container image is now `steadybit/agent`
+* All `outpost.*` values were renamed to `agent.*`
+* The sample command provided in the platform in the platform now suggests the `steadybit-agent` namespace.
+
+For migrating:
+
+1. Remove the old Helm release using `helm uninstall`
+2. Update your custom values to use the `agent.*` instead `outpost.*` of the  prefix
+3. Install the new Helm chart using `helm install`
+
+## Docker
+
+The [https://get.steadybit.com/outpost.sh](https://get.steadybit.com/outpost.sh) was renamed to [https://get.steadybit.com/agent.sh](https://get.steadybit.com/agent.sh). The scripts are structurally identical but refer to the new `steadybit/agent` container image. 
+
+For migrating:  
+
+1. stop and remove the running containers 
+2. Install using the new `agent.sh`
+
+## Linux Packages
+
+The  [https://get.steadybit.com/outpost-linux.sh](https://get.steadybit.com/outpost-linux.sh) was renamed to [https://get.steadybit.com/agent-linux.sh](https://get.steadybit.com/agent-linux.sh)[. ](https://get.steadybit.com/agent-linux.sh)The scripts are structurally identical but now install the steadybit-agent packages, and the configuration is located in `/etc/steadybit/agent.`
+
+For migrating:
+
+1. Remove the old `steadybit-outpost` packages using the system package manager
+2. Move the configuration using `sudo mv /etc/steadybit/outpost /etc/steadybit/agent`
+3. Install the new `steadybit-agent` package using your system package manager

quick-start/run-experiment-run2 (1).png

@@ -33,19 +33,19 @@ The wizard guides you step by step through the creation of the experiment. It co
 
 1. **Define Experiment** First things first: Define the basic elements of the experiments like name, hypothesis and environment (see above).
 
-![Create Experiment - Step 1: Define](<../../quick-start/run-experiment-step2.png>)
+![Create Experiment - Step 1: Define](<../../quick-start/run-experiment-step2 (2).png>)
 
 1. **Select Attack** Now you are ready to choose a suitable attack from one of the available catgories to match your hypothesis. Choose the attack with the desired effect. If needed, you are able to provide additional settings for the attack. However, the defaults are usual a good way to go. To learn more about attacks, check out our [learn-attacks-section in the docs](../../concepts/actions/).
 
-![Create Experiment - Step 2: Attack](<../../quick-start/run-experiment-step3.png>)
+![Create Experiment - Step 2: Attack](<../../quick-start/run-experiment-step3 (2).png>)
 
 1. **Select Target** You can now select your desired targets by attributes where you can use the [discovery data](../../concepts/discovery/) to specify them with a dynamically evaluated query. Since these attributes are discovered by the agents and can change from one moment to the next, it is wise to choose stable attributes. Good examples are labels, namespaces or symbolic names - whereas a unique identifier of targets (like the container id) are usually a bad idea. When the experiment is due to be executed those attributes are resolved into a concrete set of targets to be attacked. You can use the "show targets" button next to the query to evaluate it's effect and preview matching targets.
 
-![Create Experiment - Step 3: Targets](<../../quick-start/run-experiment-step4.png>)
+![Create Experiment - Step 3: Targets](<../../quick-start/run-experiment-step4 (2).png>)
 
 1. **Impact and Attack Radius** You can limit your impact by defining an attack radius. It is a best practices to start easy and not by attacking your entire target selection. Therefore, specify the attack radius as a percentage or fixed number - limiting the amount of maximum affected e.g. hosts or containers. Even so, 100% is a valid value - but you need to be explicit about that.
 
-![Create Experiment - Step 4: Impact Radius](<../../quick-start/run-experiment-step5.png>)
+![Create Experiment - Step 4: Impact Radius](<../../quick-start/run-experiment-step5 (3).png>)
 
 After saving the experiment you are ready to [run it directly](./#run) or extend it using our editor (see blank experiment).