From cee82563d88a5af1b664909bac55daca137ae29a Mon Sep 17 00:00:00 2001 From: Kyle Carberry Date: Mon, 28 Mar 2022 18:09:31 +0000 Subject: [PATCH] feat: Update README with highlights and getting started guide --- Makefile | 3 ++ README.md | 95 ++++++++++++++++++------------------------------------- 2 files changed, 33 insertions(+), 65 deletions(-) diff --git a/Makefile b/Makefile index 1feec7565321c..27502fa7b1bf2 100644 --- a/Makefile +++ b/Makefile @@ -88,3 +88,6 @@ site/out: # Restores GITKEEP files! git checkout HEAD site/out .PHONY: site/out + +test: + gotestsum -- -v -short ./... diff --git a/README.md b/README.md index c07cb1d3d2fce..12620e21b4f39 100644 --- a/README.md +++ b/README.md @@ -1,81 +1,46 @@ -[![coder](https://github.com/coder/coder/actions/workflows/coder.yaml/badge.svg)](https://github.com/coder/coder/actions/workflows/coder.yaml) -[![codecov](https://codecov.io/gh/coder/coder/branch/main/graph/badge.svg?token=TNLW3OAP6G)](https://codecov.io/gh/coder/coder) +# Coder -# Coder v2 +[!["GitHub Discussions"](https://img.shields.io/badge/%20GitHub-%20Discussions-gray.svg?longCache=true&logo=github&colorB=purple)](https://github.com/coder/coder/discussions) [!["Join us on Slack"](https://img.shields.io/badge/join-us%20on%20slack-gray.svg?longCache=true&logo=slack&colorB=brightgreen)](https://coder.com/community) [![Twitter Follow](https://img.shields.io/twitter/follow/CoderHQ?label=%40CoderHQ&style=social)](https://twitter.com/coderhq) [![codecov](https://codecov.io/gh/coder/coder/branch/main/graph/badge.svg?token=TNLW3OAP6G)](https://codecov.io/gh/coder/coder) -This repository contains source code for Coder V2. Additional documentation: +Provision remote development environments with Terraform. -- [Workspaces V2 RFC](https://www.notion.so/coderhq/b48040da8bfe46eca1f32749b69420dd?v=a4e7d23495094644b939b08caba8e381&p=e908a8cd54804ddd910367abf03c8d0a) +## Highlights -## Directory Structure +- Automate development environments for Linux, Windows, and MacOS in your cloud +- Start writing code with a single command +- Use one of many [examples](./examples) to get started -- `.github/`: Settings for [Dependabot for updating dependencies](https://docs.github.com/en/code-security/supply-chain-security/customizing-dependency-updates) and [build/deploy pipelines with GitHub Actions](https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions). - - [`semantic.yaml`](./github/semantic.yaml): Configuration for [semantic pull requests](https://github.com/apps/semantic-pull-requests) -- `examples`: Example terraform project templates. -- `site`: Front-end UI code. +## Getting Started -## Development - -### Pre-requisites - -- `git` -- `go` version 1.17, with the `GOPATH` environment variable set -- `node` -- `yarn` - -### Cloning - -- `git clone https://github.com/coder/coder` -- `cd coder` - -### Building - -- `make build` -- `make install` - -The `coder` CLI binary will now be available at `$GOPATH/bin/coder` - -### Running - -After building, the binaries will be available at: -- `dist/coder_{os}_{arch}/coder` +Install [the latest release](https://github.com/coder/coder/releases). -For the purpose of these steps, an OS of `linux` and an arch of `amd64` is assumed. +To tinker, start with dev-mode (all data is in-memory): -To manually run the server and go through first-time set up, run the following commands in separate terminals: -- `dist/coder_linux_amd64/coder daemon` <-- starts the Coder server on port 3000 -- `dist/coder_linux_amd64/coder login http://localhost:3000` <-- runs through first-time setup, creating a user and org +```bash +$ coder start --dev +``` -You'll now be able to login and access the server. +To run a production deployment with PostgreSQL: -- `dist/coder_linux_amd64/coder projects create -d /path/to/project` +```bash +$ CODER_PG_CONNECTION_URL="..." coder start +``` -### Development +To run as a daemon, use the provided service (Linux only): -- `./develop.sh` +```bash +$ sudo vim /etc/coder.d/coder.env +$ sudo service coder restart +``` -The `develop.sh` script does three things: - -- runs `coder daemon` locally on port `3000` -- runs `webpack-dev-server` on port `8080` -- sets up an initial user and organization - -This is the recommend flow for working on the front-end, as hot-reload is set up as part of the webpack config. - -Note that `./develop.sh` creates a user and allows you to log into the UI, but does not log you into the CLI, which is required for creating a project. Use the `login` command above before the `projects create` command. - -While we're working on automating XState typegen, you may need to run `yarn typegen` from `site`. - -## Front-End Plan - -For the front-end team, we're planning on 2 phases to the 'v2' work: - -### Phase 1 - -Phase 1 is the 'new-wine-in-an-old-bottle' approach - we want to preserve the look and feel (UX) of v1, while testing and validating the market fit of our new v2 provisioner model. This means that we'll preserve Material UI and re-use components from v1 (porting them over to the v2 codebase). +## Development -### Phase 2 +Code structure is inspired by [Basics of Unix Philosophy](https://homepage.cs.uri.edu/~thenry/resources/unix_art/ch01s06.html) and [Effective Go](https://go.dev/doc/effective_go); these should be read prior to contributing. -Phase 2 is the 'new-wine-in-a-new-bottle' - which we can do once we've successfully packaged the new wine in the old bottle. +Requires Go 1.18+, Node 14+, and GNU Make. -In other words, once we've validated that the new strategy fits and is desirable for our customers, we'd like to build a new, v2-native UI (leveraging designers on the team to build a first-class experience around the new provisioner model). +- `make bin` build binaries +- `make install` install binaries to `$GOPATH/bin` +- `make test` +- `make release` dry-run a new release +- `./develop.sh` hot-reloads for frontend development