Merge pull request #22 from input-output-hk/next-2024-04-19

Node-ng 8.10.1, dbsync 13.2.0.2, mithril-ng unstable, private chain stop

Justfile

@@ -1,4 +1,5 @@
-import? 'scripts/custom-recipes.just'
+import? 'scripts/recipes-aws.just'
+import? 'scripts/recipes-custom.just'
 
 set shell := ["bash", "-uc"]
 set positional-arguments
@@ -104,6 +105,10 @@ apply *ARGS:
 apply-all *ARGS:
   colmena apply --verbose {{ARGS}}
 
+# Deploy select machines with the bootstrap key
+apply-bootstrap *ARGS:
+  SSH_CONFIG=<(sed '6i IdentityFile .ssh_key' .ssh_config) colmena apply --verbose --on {{ARGS}}
+
 # Build the prod cardano book
 build-book-prod:
   #!/usr/bin/env bash

README.md

@@ -25,7 +25,7 @@ While working on the next step, you can already start the devshell using:
 
     nix develop
 
-This will be done automatically if you are using [direnv](https://direnv.net/).
+This will be done automatically if you are using [direnv](https://direnv.net/) and issue `direnv allow`.
 
 ## AWS
 
@@ -46,10 +46,13 @@ SRE cluster secret in `~/.age/credentials`:
     # cardano-playground: sre
     AGE-SECRET-KEY-***********************************************************
 
+If needed, a new secret can be generated with `age-keygen`.
+
 ## SSH
 
-If your credentials are correct, you will be able to access SSH after creating
-an `./.ssh_config` using:
+If your credentials are correct, and the cluster is already bootstrapped with
+openTofu infrastructure, you will be able to access SSH after creating an
+`./.ssh_config` using:
 
     just save-ssh-config
 

docs/environments/mainnet/topology-non-bootstrap-peers.json

@@ -20,6 +20,10 @@
         {
           "address": "backbone.mainnet.emurgornd.com",
           "port": 3001
+        },
+        {
+          "address": "backbone.mainnet.cardanofoundation.org",
+          "port": 3001
         }
       ],
       "advertise": false

docs/environments/mainnet/topology.json

@@ -7,6 +7,10 @@
     {
       "address": "backbone.mainnet.emurgornd.com",
       "port": 3001
+    },
+    {
+      "address": "backbone.mainnet.cardanofoundation.org",
+      "port": 3001
     }
   ],
   "localRoots": [

docs/explain/old-node-configs.md

@@ -0,0 +1,91 @@
+# Obtaining old node configurations
+* Generally, the [Cardano Operations Book](https://book.play.dev.cardano.org)
+  will only contain the current release and next pre-release cardano-node
+  configurations.
+
+* To obtain an old set of node configuration files, the official node release
+  binary of the desired version may already contain the configuration for the
+  environment being sought.
+
+* As a first alternative, configs for old node versions can be built from the
+  cardano-node repository and the desired version tag using nix with the
+  following command where the configs will then be located in the result/
+  directory:
+```
+nix build github:intersectmbo/cardano-node/$VERSION_TAG#hydraJobs.x86_64-linux.cardano-deployment
+```
+
+* As a second alternative, the configs can be found through hydra if nix isn't
+  available, although it requires following the path from the hydra CI required
+  job:
+  1) Using the URL of the cardano-node tag commit that follows, find the
+  `ci/hydra-build:required` GHA job and select `View more details on IOG
+  Hydra`:
+      ```
+      https://github.com/IntersectMBO/cardano-node/commits/$VERSION_TAG
+      ```
+
+  2) On the hydra navigate to the `cardano-deployment` hydra build:
+      ```
+      constituents -> x86_64-linux.required -> constituents -> x86.64_linux.cardano-deployment
+      ```
+
+  3) This provides a link to `https://ci.iog.io/build/$BUILD_NUM` which has a
+  report that provides a download page that configs may be downloaded from:
+      ```
+      https://ci.iog.io/build/$BUILD_NUM/download/1/index.html
+      ```
+
+* As a third alternative, node configuration may be generated from the
+  cardano-playground repository by running the given command and finding the
+  appropriate files at the indicated path.
+
+  * Note that `nix >= 2.17.0` with the following experimental features is
+    required:
+    ```
+    experimental-features = nix-command flakes fetch-closure
+    ```
+
+## Version Reference:
+
+* Node `8.10.0-pre`
+  * Environment configs can be found in `result/environments-pre/config/` after running:
+    ```
+    nix run github:input-output-hk/cardano-playground/node-8.10.0-pre-config#job-gen-env-config
+    ```
+
+* Node `8.9.2`
+  * Environment configs can be found in `result/environments/config/` after running:
+    ```
+    nix run github:input-output-hk/cardano-playground/node-8.9.2-config#job-gen-env-config
+    ```
+
+* Node `8.9.1`
+  * Environment configs can be found in `result/environments/config/` after running:
+    ```
+    nix run github:input-output-hk/cardano-playground/node-8.9.1-config#job-gen-env-config
+    ```
+
+* Node `8.9.0`
+  * Environment configs can be found in `result/environments/config/` after running:
+    ```
+    nix run github:input-output-hk/cardano-playground/node-8.9.0-config#job-gen-env-config
+    ```
+
+* Node `8.8.1-pre`
+  * Environment configs can be found in `result/environments-pre/config/` after running:
+    ```
+    nix run github:input-output-hk/cardano-playground/node-8.8.1-pre-config#job-gen-env-config
+    ```
+
+* Node `8.8.0-pre`
+  * Environment configs can be found in `result/environments-pre/config/` after running:
+    ```
+    nix run github:input-output-hk/cardano-playground/node-8.8.0-pre-config#job-gen-env-config
+    ```
+
+* Node `8.7.3`
+  * Environment configs can be found in `result/environments/config/` after running:
+    ```
+    nix run github:input-output-hk/cardano-playground/node-8.7.3-config#job-gen-env-config
+    ```