You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
summary: "Customers use Kosli to attest evidence of their business and software processes. If Kosli is down, these attestations will fail. In this situation there is a built-in mechanism to instantly turn Kosli off and keep the pipelines flowing. When Kosli is back up, you can instantly turn Kosli back on."
5
+
summary: 'Customers use Kosli to attest evidence of their business and software processes. If Kosli is down, these attestations will fail. In this situation there is a built-in mechanism to instantly turn Kosli off and keep the pipelines flowing. When Kosli is back up, you can instantly turn Kosli back on.'
6
6
---
7
7
8
8
# What do I do if Kosli is down?
@@ -13,29 +13,33 @@ This will break CI workflow pipelines, blocking artifacts from being deployed.
13
13
In this situation there is a built-in mechanism to instantly turn Kosli off and keep the pipelines flowing.
14
14
When Kosli is back up, you can instantly turn Kosli back on.
15
15
16
+
{{% hint info %}}
17
+
You can check the current status of Kosli services at https://status.app.kosli.com or by running `kosli status` in the CLI.
18
+
{{% /hint %}}
19
+
16
20
## Turning Kosli CLI calls on and off instantly
17
21
18
22
If the `KOSLI_DRY_RUN` environment variable is set to `true` then all Kosli CLI commands will:
19
-
* Not communicate with Kosli at all
20
-
* Print the payload they would have sent
21
-
* Exit with a zero status code
23
+
24
+
- Not communicate with Kosli at all
25
+
- Print the payload they would have sent
26
+
- Exit with a zero status code
22
27
23
28
We recommend creating an Org-level KOSLI_DRY_RUN variable in your CI system and, in all CI workflows,
24
-
ensuring there is an environment variable set from it.
29
+
ensuring there is an environment variable set from it.
25
30
26
31
For example, in a [Github Action workflow](https://github.com/cyber-dojo/differ/blob/main/.github/workflows/main.yml):
27
32
28
33
```yaml
29
34
name: Main
30
-
...
35
+
---
31
36
env:
32
-
KOSLI_DRY_RUN: ${{ vars.KOSLI_DRY_RUN }} # true iff Kosli is down
37
+
KOSLI_DRY_RUN: ${{ vars.KOSLI_DRY_RUN }} # true iff Kosli is down
33
38
```
34
39
35
-
36
40
## Turning Kosli API calls on and off instantly
37
41
38
-
If you are using the Kosli API in your workflows (e.g. using `curl`), we recommend using the same Org-level `KOSLI_DRY_RUN`
42
+
If you are using the Kosli API in your workflows (e.g. using `curl`), we recommend using the same Org-level `KOSLI_DRY_RUN`
39
43
environment variable and guarding the `curl` call with a simple if statement. For example:
0 commit comments