docs

Author: skudasov

book/src/SUMMARY.md

@@ -14,7 +14,7 @@
     - [CLI](./framework/cli.md)
     - [Configuration](./framework/configuration.md)
     - [Test Configuration](./framework/test_configuration_overrides.md)
-    - [Components Persistence](framework/components/state.md)
+    - [Exposing Components](framework/components/state.md)
     - [Components Cleanup](framework/components/cleanup.md)
     - [Components Caching](framework/components/caching.md)
     - [External Environment](framework/components/external.md)

book/src/framework/components/state.md

@@ -1,4 +1,4 @@
-# Components Persistence
+# Exposing Components (Data and ports)
 
 We use static port ranges and volumes for all components to simplify Docker port management for developers.
 
@@ -27,6 +27,7 @@ Defaults are:
 
 When you run `ctf d rm` database volume will be **removed**.
 
+
 <div class="warning">
 
 One node set is enough for any kind of testing, if you need more nodes consider extending your existing node set:
@@ -35,3 +36,24 @@ One node set is enough for any kind of testing, if you need more nodes consider
   nodes = 10
 ```
 </div>
+
+## Custom ports
+
+You can also define a custom set of ports for any node
+```toml
+[nodeset]
+  nodes = 5
+  override_mode = "each"
+
+  [[nodeset.node_specs]]
+
+    [nodeset.node_specs.db]
+      image = "postgres:15.6"
+      pull_image = true
+
+    [nodeset.node_specs.node]
+      # here we defined 2 new ports to listen and mapped them to our host machine
+      custom_ports = [14000, 14001]
+      image = "public.ecr.aws/chainlink/chainlink:v2.16.0"
+      pull_image = false
+```