···

       
71
       
 
       
{

     

       
72
       
 
       
  name = "…";

     

       
73
       
 
       
  nodes.machines = { /* … */ };

     

       
74
       
-
       
  sshBackdoor.enable = true;

     

       
75
       
 
       
}

     

       
76
       
 
       
```

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
77
       
 
       


     

       
78
       
 
       
This creates a [vsock socket](https://man7.org/linux/man-pages/man7/vsock.7.html)

     

       
79
       
 
       
for each VM to log in with SSH. This configures root login with an empty password.

     

···

       
71
       
 
       
{

     

       
72
       
 
       
  name = "…";

     

       
73
       
 
       
  nodes.machines = { /* … */ };

     

       
74
       
+
       
  interactive.sshBackdoor.enable = true;

     

       
75
       
 
       
}

     

       
76
       
 
       
```

     

       
77
       
+
       


     

       
78
       
+
       
::: {.warning}

     

       
79
       
+
       
Make sure to only enable the backdoor for interactive tests

     

       
80
       
+
       
(i.e. by using `interactive.sshBackdoor.enable`)! This is the only

     

       
81
       
+
       
supported configuration.

     

       
82
       
+
       


     

       
83
       
+
       
Running a test in a sandbox with this will fail because `/dev/vhost-vsock` isn't available

     

       
84
       
+
       
in the sandbox.

     

       
85
       
+
       
:::

     

       
86
       
 
       


     

       
87
       
 
       
This creates a [vsock socket](https://man7.org/linux/man-pages/man7/vsock.7.html)

     

       
88
       
 
       
for each VM to log in with SSH. This configures root login with an empty password.

     

···

       
43
       
 
       
  };

     

       
44
       
 
       


     

       
45
       
 
       
  config = {

     

       
46
       
-
       
    rawTestDerivation = hostPkgs.stdenv.mkDerivation {

     

       
47
       
-
       
      name = "vm-test-run-${config.name}";

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
48
       
 
       


     

       
49
       
-
       
      requiredSystemFeatures =

     

       
50
       
-
       
        [ "nixos-test" ]

     

       
51
       
-
       
        ++ lib.optionals hostPkgs.stdenv.hostPlatform.isLinux [ "kvm" ]

     

       
52
       
-
       
        ++ lib.optionals hostPkgs.stdenv.hostPlatform.isDarwin [ "apple-virt" ];

     

       
53
       
 
       


     

       
54
       
-
       
      buildCommand = ''

     

       
55
       
-
       
        mkdir -p $out

     

       
56
       
 
       


     

       
57
       
-
       
        # effectively mute the XMLLogger

     

       
58
       
-
       
        export LOGFILE=/dev/null

     

       
59
       
 
       


     

       
60
       
-
       
        ${config.driver}/bin/nixos-test-driver -o $out

     

       
61
       
-
       
      '';

     

       
62
       
 
       


     

       
63
       
-
       
      passthru = config.passthru;

     

       
64
       
 
       


     

       
65
       
-
       
      meta = config.meta;

     

       
66
       
-
       
    };

     

       
67
       
 
       
    test = lib.lazyDerivation {

     

       
68
       
 
       
      # lazyDerivation improves performance when only passthru items and/or meta are used.

     

       
69
       
 
       
      derivation = config.rawTestDerivation;

     

···

       
43
       
 
       
  };

     

       
44
       
 
       


     

       
45
       
 
       
  config = {

     

       
46
       
+
       
    rawTestDerivation =

     

       
47
       
+
       
      assert lib.assertMsg (!config.sshBackdoor.enable)

     

       
48
       
+
       
        "The SSH backdoor is currently not supported for non-interactive testing! Please make sure to only set `interactive.sshBackdoor.enable = true;`!";

     

       
49
       
+
       
      hostPkgs.stdenv.mkDerivation {

     

       
50
       
+
       
        name = "vm-test-run-${config.name}";

     

       
51
       
 
       


     

       
52
       
+
       
        requiredSystemFeatures =

     

       
53
       
+
       
          [ "nixos-test" ]

     

       
54
       
+
       
          ++ lib.optionals hostPkgs.stdenv.hostPlatform.isLinux [ "kvm" ]

     

       
55
       
+
       
          ++ lib.optionals hostPkgs.stdenv.hostPlatform.isDarwin [ "apple-virt" ];

     

       
56
       
 
       


     

       
57
       
+
       
        buildCommand = ''

     

       
58
       
+
       
          mkdir -p $out

     

       
59
       
 
       


     

       
60
       
+
       
          # effectively mute the XMLLogger

     

       
61
       
+
       
          export LOGFILE=/dev/null

     

       
62
       
 
       


     

       
63
       
+
       
          ${config.driver}/bin/nixos-test-driver -o $out

     

       
64
       
+
       
        '';

     

       
65
       
 
       


     

       
66
       
+
       
        passthru = config.passthru;

     

       
67
       
 
       


     

       
68
       
+
       
        meta = config.meta;

     

       
69
       
+
       
      };

     

       
70
       
 
       
    test = lib.lazyDerivation {

     

       
71
       
 
       
      # lazyDerivation improves performance when only passthru items and/or meta are used.

     

       
72
       
 
       
      derivation = config.rawTestDerivation;