docs: add net-loadtest to contributing.md

Also delete previous nixops scripts as they're no longer needed.

Author: steve-chavez

docs/contributing.md

@@ -16,13 +16,18 @@ $ cachix use nxpg
 # might take a while in downloading all the dependencies
 $ nix-shell
 
+# test on latest pg
+$ xpg test
+
 # test on pg 12
 $ xpg -v 12 test
 
 # test on pg 13
 $ xpg -v 13 test
 ```
 
+This will spawn a local db and an nginx server for testing.
+
 ### Debugging
 
 You can turn on logging level to see curl traces with
@@ -66,32 +71,28 @@ $ sudo net-with-gdb
 
 ## Load Testing
 
-These are scripts that wrap NixOps to deploy an AWS cloud setup. You must have `default` setup in `.aws/credentials`.
-
-```bash
-net-cloud-deploy
-```
+The `net-loadtest` launchs a temporary db and a nginx server, waiting until a number of requests are done, then reporting results (plus process monitoring) at the end.
 
-Then you can connect on the client instance and do requests to the server instance through `pg_net`.
+It takes a two parameters: the number of requests (GETs) and the `pg_net.batch_size`.
 
 ```bash
-net-cloud-ssh
-
-psql -U postgres
+$ net-loadtest 1000 200
+...
 
-select net.http_get('http://server');
-# this the default welcome page of nginx on the server instance
-# "server" is already included to /etc/hosts, so `curl http://server` will give the same result
+## Loadtest results
 
-# do some load testing
-select net.http_get('http://server') from generate_series(1,1000);
-# run `top` on another shell(another `nixops ssh -d pg_net client`) to check the worker behavior
-```
+|   requests |   batch_size | time_taken      |   request_successes |   request_failures | last_failure_error   |
+|-----------:|-------------:|:----------------|--------------------:|-------------------:|:---------------------|
+|       1000 |          200 | 00:00:04.198886 |                1000 |                  0 |                      |
 
-To destroy the cloud setup:
+## Loadtest elapsed seconds vs CPU/MEM
 
-```bash
-net-cloud-destroy
+|   Elapsed time |   CPU (%) |   Real (MB) |   Virtual (MB) |
+|----------------|-----------|-------------|----------------|
+|          0     |         0 |      20.227 |        437.426 |
+|          1     |         2 |      20.227 |        437.566 |
+|          2.001 |         4 |      20.418 |        437.566 |
+|          3.002 |         3 |      20.418 |        437.566 |
 ```
 
 ## Documentation

nix/nixops.nix

@@ -6,13 +6,7 @@ with import (builtins.fetchTarball {
 mkShell {
   buildInputs =
     let
-      nixpkgs2405 = import (builtins.fetchTarball {
-          name = "24.05";
-          url = "https://github.com/NixOS/nixpkgs/archive/refs/tags/24.05.tar.gz";
-          sha256 = "sha256:1lr1h35prqkd1mkmzriwlpvxcb34kmhc9dnr48gkm8hh089hifmx";
-      }) {};
       nginxCustom = callPackage ./nix/nginxCustom.nix {};
-      nixopsScripts = callPackage ./nix/nixopsScripts.nix {nixops_unstable_minimal = nixpkgs2405.nixops_unstable_minimal;};
       xpg = callPackage ./nix/xpg.nix {inherit fetchFromGitHub;};
       loadtest = callPackage ./nix/loadtest.nix {};
       pythonDeps = with python3Packages; [
@@ -27,7 +21,7 @@ mkShell {
       nginxCustom.nginxScript
       curlWithGnuTls
       loadtest
-    ] ++ nixopsScripts;
+    ];
   shellHook = ''
     export HISTFILE=.history
   '';