Install Docker, Docker Compose, and Go.
docker compose -f build/docker-compose.yml up -d
make test
RACE=y make test
docker compose -f build/docker-compose.yml down
First complete the above steps. Then:
atlas-create org testorg [email protected] testpass
API_PWT_KEY=$(dd if=/dev/random bs=1 count=32|base64) API_API_HOST=127.0.0.1 atlas-api
curl -v -X POST -d '{"email":"[email protected]", "orgName":"testorg", "password":"testpass"}' http://localhost:8000/v1/sessions/login
OpenAPI live docs are available at http://localhost:8000/.
Docker Compose files for the Atlas platform
and its dependencies are available in build/deploy/
. These can be used for a
single-system deploy, or as templates for orchestration tooling such as
Nomad or Kubernetes.
Keys should be provided where applicable.
All non-generated test files should have build tags, including main_test.go
.
Due to limitations of developer tools and extensions, negated tags are used.
For example, to tag a file as a unit test:
// +build !integration
To tag a file as an integration test:
// +build !unit
To find test files that are missing build tags, the following command can be run:
find . -name '*_test.go' -type f|grep -v /mock_|xargs grep -L '//go:build'