garden-io / garden-coder-example Goto Github PK

This repository contains an example project that demonstrates how to use Garden and Coder together.

• Garden is a DevOps automation platform that lets you spin-up production-like environments for development, testing and CI on demand.
• Coder is a self-hosted remote development platform that shifts software development from local machines to the cloud.

Together, they allow you to leverage the power of the cloud to develop a system of any complexity fully remotely with instant feedback that feels like local. See below for a quick demo video 👇

To try this example you'll need:

• The Garden CLI
• A clone of this example project

You can quickly install the Garden CLI with:

curl -sL https://get.garden.io/install.sh | bash

If you have the Garden CLI installed and a clone of this example project, log in from inside the example directory with:

garden login

If this is your first time logging in, you'll be asked to sign up via GitHub.

To simplify the next steps, we'll create a Garden access token and add it to the shell environment.

Open the Garden dashboard users page, then click the 'edit' icon next to your user name. This will open the user settings where you can create the access token. Copy the value and add it to your environment:

export CODER_GARDEN_TOKEN=<your-garden-auth-token>

Now you can deploy the project from the example directory with:

garden deploy

This will deploy Coder to a Garden managed ephemeral cluster and create a workspace for your user.

You can now follow the link in your terminal (it'll look like https://coder.<random-string>.preview.garden) to open Coder in your browser and log in with the initial user credentials:

• Username: [email protected]
• Password: VeryStrongCoderPassword1234!

Once you've logged into your Coder instance, open the "dev" workspace that was created automatically when you ran the garden deploy command. The workspace will have Garden installed and a clone of the example app.

Open a terminal in your workspace and change into the example app directory:

cd quickstart-example

Then deploy the app with Garden by running the following from your Coder terminal:

garden deploy --sync

And that's it! ✨

You've just deployed your fully remote development environment, and from that environment, a separate production-like environment for the actual example app.

The example is a voting app from Garden's Quickstart example repository and you can learn more about it there.

Garden enables you to codify your workflows, kind of like a makefile for cloud native development. When you run the garden deploy command it does the following:

• Spins up an ephemeral Kubernetes cluster (because that's the Garden plugin we're using in the project.garden.yml file)
• Installs a Postgres database and a Coder server (based on the config in the coder/garden.yml file)
• Runs a handful of actions to initialize Coder and create the first workspace

Inside your Coder workspace you again use Garden, this time to deploy an example app. Here, Garden does the following:

• Deploys the example app to the same Kubernetes cluster but a different namespace (because the example is using the same Garden plugin)
• Enables live code syncing so that changes you make inside Coder update the example app immediately

Garden is typically used by teams with relatively large projects that run on Kubernetes and can't be easily developed or tested in a local environment.

Coder is typically used by teams who prefer writing their code in remote environments, e.g. for security reasons and/or to ensure development environments are consistent.

Using Garden and Coder together is therefore ideal for teams that want to address both concerns. That is, teams that need to be able to rapidly iterate on systems of any complexity without the source code ever touching their local machines.

To make it easy to try things out, this example uses Garden managed ephemeral clusters—a zero-config sandbox environment that gets created on demand. To deploy Coder to your own Kubernetes cluster, follow the instructions here and update the values in project.garden.yml file.

• The Garden dashboard Live page does not work when running Garden from within Coder. Other dashboard pages work as expected.
• The Deploy action isn't idempotent because the init step can't run twice. To just deploy Coder and skip initialization, run garden deploy coder-server.

• Garden documentation
• Coder documentation
• The example app