feat: update pgctld, resolve version in pkg, update docs (#2088)

Author: samrose

docs/multigres-image.md

@@ -216,3 +216,25 @@ cp /tmp/tmp.<id>/regression_output/results/z_multigres-orioledb-17_*.out nix/tes
 > `pgmq.out`, `http.out`) from multigres test runs back to `nix/tests/expected/`.
 > Those files are patched at runtime by the test harness and will break other
 > image tests if overwritten with patched content.
+
+
+## Updating multigres
+
+1. run `nix flake update multigres` from root of repo (it should only change `flake.lock` file)
+2. `git add flake.lock`
+3. `nix build .#pgctld` and update `nix/packages/pgctld.nix`  `vendorHash` with returned value
+   example `vendorHash = "sha256-cqSd6Dv0WYOVwg7AE1tZPh9uzsjDG32gF6eJzARsHo8=";`
+4. `git add nix/packages/pgctld.nix`
+5. run the tests locally with 
+  a. `nix run .#docker-image-test -- --target variant-17 Dockerfile-multigres`
+  b. `nix run .#docker-image-test -- --target variant-orioledb-17 Dockerfile-multigres`
+6. release the images by incrementing these values in `ansible/vars.yaml` by 1 
+
+# Full version strings for each major version
+```
+postgres_release:
+  postgresorioledb-17: "17.6.0.054-orioledb"
+  postgres17: "17.6.1.097"
+  postgres15: "15.14.1.097"     
+```
+Then you can push the changes if the images pass those tests

flake.lock

@@ -5,7 +5,7 @@
 }:
 buildGoModule {
   pname = "pgctld";
-  version = "0.1.0";
+  version = multigres-src.rev;
   src = multigres-src;
   subPackages = [ "go/cmd/pgctld" ];
   env.CGO_ENABLED = "0";
@@ -17,7 +17,7 @@ buildGoModule {
   '';
   # Tests require a running PostgreSQL instance (integration tests); skip in sandbox.
   doCheck = false;
-  vendorHash = "sha256-HesmA96WVxnBvspLc9FZ5M4m5J/T5r6ymaui8g58yMM=";
+  vendorHash = "sha256-cqSd6Dv0WYOVwg7AE1tZPh9uzsjDG32gF6eJzARsHo8=";
 
   meta = {
     description = "PostgreSQL control daemon for Multigres cluster lifecycle management";