The native CLI

This executable sets up a local development cluster with a pass-through container registry, mount-through nix store and external load balancer. It’s automatically accessible as a tool in the nativelink development flake and self contained to be usable in external projects.

Danger

Make sure that you don’t have an existing Pulumi stack or kubectl context active. Otherwise you might accidentally deploy into clusters other than the local kind cluster that the native CLI creates.

NativeLink nix flake

To run the cluster:

native up

To shut the cluster down:

native down

Standalone invocation

To run the cluster from outside of the development flake:

nix run github:TraceMachina/nativelink#native up

To shut the cluster down from outside of the development flake:

nix run github:TraceMachina/nativelink#native down

Note

The containers for the container registry and the load balancer are currently not cleaned up and need to be deleted manually:

# Get the container IDs for the registry and load balancer
docker container ls

# Delete the images
docker container stop SOME_CONTAINER_ID
docker container rm SOME_CONTAINER_ID

Updating dependencies

From within the Nix flake:

go get -u ./...
go mod tidy

Then go to default.nix and adjust the vendorHash field:

1. Change one character in the hash to invalidate it. Otherwise nix would wrongly reuse locally cached go modules the package updates.

2. Run nix develop

3. You should see an error message like:

   error: hash mismatch in fixed-output derivation ...
            specified: XXX
               got:    YYY

4. Substitute the old vendorHash value with YYY.

5. Re-run nix develop. It should now build.

Making code changes

Ensure that the entire application remains self-contained. This means that no dynamic paths should point into the nativelink repository. Instead, use the //go:embed directive to embed for example templates into the executable rather than reading them disk at runtime.

The same applies to the packaging logic in default.nix. Pulumi should be bundled via a nix wrapper so that we don’t rely on a user’s local Pulumi installation.