Merge pull request #575 from input-output-hk/jpraynaud/500-new-environments

New environments documentation

Author: jpraynaud

docs/blog/2022-10-28-updated-environments.md

@@ -0,0 +1,37 @@
+---
+title: Mithril environments are updated
+authors:
+- name: Mithril Team
+tags: [release-process, re-spin, preview, preprod, environments]
+---
+
+### The Mithril environments are updated
+
+**PR**: `New hosted environments` [#561](https://github.com/input-output-hk/mithril/pull/561)
+
+**Issue**: `Setup new hosted environments for testing-preview, pre-release-preview and release-preprod) with their terraform and GitHub environments` [#542](https://github.com/input-output-hk/mithril/issues/542)
+
+On Tuesday, November 1st, 2022 the `preview` Cardano network will be re-spun and will be unavailable for 48h.
+
+In the mean time, the Mitril team is also implementing a new Release Process that will make use of several new environments.
+
+The Mithril testing environments are thus evolving in this context:
+
+- The current testing environment that runs on `preview` network and that most of the Pioneer SPOs are running is **deprecated** and will be decommissioned just after the `preview` network re-spin.
+
+- This environment will then be replaced by a new `pre-release-preview` environment open to SPOs that are eager to test pre releases of the Mithril nodes.
+
+- A new `release-preprod` environment has been launched on the `preprod` Cardano nework and will become the `stable` environment on which SPOs are encouraged to run their nodes.
+
+- :warning: The new `release-preprod` environment is in `unstable` status, therefore it is subject to re-genesis. We expect it to be in `stable` status within 1-2 weeks.
+
+In the future, when Mithril reaches `mainnet`, we assume that the `release-preprod` will be replaced by a `release-mainnet` environment. This means that we will have the following environments at this time: `testing-preview`, `pre-release-preprod` and `release-mainnet`.
+
+More information about:
+
+- The `Mithril Networks` and their availability [here](https://mithril.network/doc/manual/developer-docs/references#mithril-networks).
+
+- The `Release Process` is available in this [ADR](https://mithril.network/doc/adr/3).
+
+
+Feel free to reach out to us on the [Discord channel](https://discord.gg/5kaErDKDRq) for questions and/or help.

docs/root/manual/developer-docs/references.md

@@ -18,6 +18,19 @@ For more information about the **Mithril Protocol**, please refer to the [About
 
 :::
 
+## Mithril Networks
+
+Here is an up ot date list of all the Mithril Networks and their status
+> Last update: 10/28/2022
+
+| Mithril Network | Cardano Network | Magic Id | Supported | Aggregator Endpoint | Genesis Verification Key | Note
+|------------|------------|:-----------:|:------------:|:-----------------:|:------------------:|:------------|
+| `release-mainnet` | `mainnet` | - | :x: | - | - | Not supported yet
+| `release-preprod` | `preprod` | `1` | :warning: | [:arrow_upper_right:](https://aggregator.release-preprod.api.mithril.network/aggregator) | [:arrow_upper_right:](https://raw.githubusercontent.com/input-output-hk/mithril/main/TEST_ONLY_genesis.vkey) | Supported but subject to re-genesis shortly
+| `testing-preview` | `preview` | `2` | :warning: | [:arrow_upper_right:](https://aggregator.api.mithril.network/aggregator) | [:arrow_upper_right:](https://raw.githubusercontent.com/input-output-hk/mithril/main/TEST_ONLY_genesis.vkey) | Supported but it will be re-spun after the `preview` network re-spin, and endpoint location will be updated
+| `dev-devnet` | `devnet` | `42` | :heavy_check_mark: | [:arrow_upper_right:](http://localhost:8080/aggregator) | - | Supported on the `devnet` only
+| `-` | `testnet` | `1097911063` | :x: | - | - | Decommissioned, not supported anymore
+
 ## Dependencies List
 
 | Dependency | Description | Source Repository | Rust Documentation | REST API
@@ -32,14 +45,3 @@ For more information about the **Mithril Protocol**, please refer to the [About
 | **Mithril Explorer** | The explorer website that connects to a **Mithril Aggregator** and displays its **Certificate Chain**. | [:arrow_upper_right:](https://github.com/input-output-hk/mithril/blob/main/mithril-test-lab/mithril-end-to-end) | - | -
 | **Protocol Simulation** | A simple cli that helps understand how the **Mithril Protocol** works and the role of its protocol parameters. | [:arrow_upper_right:](https://github.com/input-output-hk/mithril/blob/main/demo/protocol-demo) | - | -
 
-## Mithril Networks
-
-The Mithril Networks are aligned with the Cardano Networks and have the same name
-
-| Network Code | Magic Id | Supported | Aggregator Endpoint | Genesis Verification Key | Note
-|------------|:-----------:|:------------:|:-----------------:|:------------------:|:------------|
-| `mainnet` | - | :x: | - | - | Not supported yet
-| `testnet` | `1097911063` | :x: | - | - | Deprecated, not supported anymore
-| `preprod` | `1` | :x: | - | - | Not implemented yet
-| `preview` | `2` | :heavy_check_mark: | [:arrow_upper_right:](https://aggregator.api.mithril.network/aggregator) | [:arrow_upper_right:](https://raw.githubusercontent.com/input-output-hk/mithril/main/TEST_ONLY_genesis.vkey) | Supported
-| `devnet` | `42` | :heavy_check_mark: | [:arrow_upper_right:](http://localhost:8080/aggregator) | - | Supported on the `devnet` only