History

William Carroll 8562bf5b5a Rename //deploy -> //nix_gcr I create //deploy when I first deployed a few applications that I packaged with Nix. This was before I setup socrates as my "cloud". Now I deploy all of my services using NixOS. The name "deploy" is a bit stale. I'm renaming it //nix_gcr because it documents how I can deploy Nix-packaged projects on Google Cloud Run.		2020-04-05 15:40:47 +01:00
..
cloud_run.nix	Rename //deploy -> //nix_gcr	2020-04-05 15:40:47 +01:00
config.lisp	Rename //deploy -> //nix_gcr	2020-04-05 15:40:47 +01:00
README.md	Rename //deploy -> //nix_gcr	2020-04-05 15:40:47 +01:00

README.md

Nix + Google Cloud Run (i.e. GCR)

I'm documenting how I currently deploy projects that I package with Nix on Google Cloud Run.

I'd like to automate this workflow as much as possible, and I intend to do just that. For now, I'm running things manually until I can design an generalization that appeals to me.

Dependencies

nix-build
docker
gcloud

Step-by-step

Use nix-build to create our Docker image for Cloud Run.

> nix-build ./cloud_run.nix

This outputs a Docker image at ./result.

Load the built image (i.e. ./result) into docker so that we can tag it and push it to the Google Container Registry (i.e. GCR).

> sudo docker load <./result

(Optionally) Run the image locally to verify its integrity.

> sudo docker run -d -p 8080:4242 <name>:<tag>

Tag and push the image to GCR.

> sudo docker tag <name>:<label> gcr.io/<google-cloud-project-id>/<name>:<latest>

Visit Google Cloud Run; create a new service with "Create Service"; select the uploaded Docker image from the "Container Image URL" field; click "Create" to deploy.

Notes

You may need to authorize gcloud by running the following:

> sudo gcloud auth login --no-launch-browser

You must use sudo here since the docker invocations are prefixed with sudo as well.

Todos

If possible, prefer using a command line tool like gcloud to create the Cloud Run service.