mirror of
https://github.com/GlueOps/autoglue.git
synced 2026-02-13 12:50:05 +01:00
7985b310c5
Refactor routing logic (Chi can be a pain when you're managing large sets of routes, but its one of the better options when considering a potential gRPC future)
Upgrade API Generation to fully support OAS3.1
Update swagger interface to RapiDoc - the old swagger interface doesnt support OAS3.1 yet
Docs are now embedded as part of the UI - once logged in they pick up the cookies and org id from what gets set by the UI, but you can override it
Other updates include better portability of the db-studio
Signed-off-by: allanice001 <allanice001@gmail.com>
123 lines
3.2 KiB
Markdown
123 lines
3.2 KiB
Markdown
# Autoglue
|
|
|
|
## Setup Env
|
|
create .env file:
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
## Bring up Database:
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
## Generate JWT tokens used for auth in the DB
|
|
Private Key is encrypted by `JWT_PRIVATE_ENC_KEY`
|
|
If this is not set, the private key is stored in plain text in the DB - its never exposed at any rate
|
|
|
|
```bash
|
|
go run . keys generate
|
|
```
|
|
|
|
## Generate master encryption key
|
|
The master encryption key is used to generate the org encryption keys - without it there will be failures
|
|
```bash
|
|
go run . encrypt create-master
|
|
```
|
|
|
|
## Ensure your swagger and SDKs are up to date with the api spec
|
|
```bash
|
|
make swagger
|
|
make sdk-all
|
|
```
|
|
|
|
## Build terraform provider
|
|
Currently, the terraform provider consumes the go sdk through an alias
|
|
Once the SDK is published to its own repo, the alias can be removed. but this is why its imperative to ensure the SDK is up to date
|
|
|
|
The command below builds the provider binary, and installs it where terraform expects it to be placed if it were downloaded from a registry
|
|
```bash
|
|
cd terraform-provider-autoglue
|
|
make dev
|
|
```
|
|
|
|
## See UI & terraform in action
|
|
From the project root
|
|
## UI & API - required for the terraform
|
|
Start the API & UI (the env embeds it with a dev proxy)
|
|
|
|
if you witness a failure here, run `make ui`
|
|
|
|
This is most likely the SPA handler trying to embed ui files that dont exist
|
|
```bash
|
|
go run .
|
|
```
|
|
|
|
From your GLUEOPS profiled browser - http://localhost:8080
|
|
Login - this is restricted to glueops.dev at the minute (in google workspace settings - outside of the API)
|
|
|
|
Create your org (http://localhost:8080/me) - you should be redirected here after initial login
|
|
|
|
Once you have an org - create a set of api keys for your org:
|
|
They will be in the format of:
|
|
Example values only; these are not real secrets.
|
|
```text
|
|
Org Key: org_lnJwmyyWH7JC-JgZo5v3Kw
|
|
Org Secret: fqd9yebGMfK6h5HSgWn4sXrwr9xlFbvbIYtNylRElMQ
|
|
```
|
|
|
|
use them in terraform/envs/dev/terraform.tfvars
|
|
|
|
in my example here, i also create ssh keys in my example:
|
|
```terraform
|
|
org_key = "org_lnJwmyyWH7JC-JgZo5v3Kw"
|
|
org_secret = "fqd9yebGMfK6h5HSgWn4sXrwr9xlFbvbIYtNylRElMQ"
|
|
|
|
ssh_keys = {
|
|
bastionKey = {
|
|
name = "Bastion Key"
|
|
comment = "deploy@autoglue"
|
|
type = "rsa"
|
|
bits = 4096
|
|
enable_download = true
|
|
download_part = "both"
|
|
download_dir = "out/bastionKey"
|
|
}
|
|
clusterKey = {
|
|
name = "Cluster Key"
|
|
comment = "bastion@autoglue"
|
|
type = "ed25519" # bits ignored
|
|
enable_download = true
|
|
download_part = "both"
|
|
download_dir = "out/clusterKey"
|
|
}
|
|
}
|
|
|
|
```
|
|
|
|
explore `main.tf` for how the module ssh-keys module is used
|
|
also you will see there how to create servers using the servers module
|
|
|
|
in `terraform/envs/dev`
|
|
```bash
|
|
rm -rf .terraform*
|
|
tofu init -upgrade
|
|
|
|
tofu plan
|
|
|
|
tofu apply -auto-approve
|
|
```
|
|
|
|
If everything went to plan, you'll have an `out` directory containting 2 zip file - one for each of the ssh keys
|
|
|
|
In the UI you will also see the SSH Keys on its page,
|
|
you will also see the servers created on its page.
|
|
|
|
## <span style="color:red">WARNING</span>
|
|
<span style="color:red">!!!!Terraform destroy deletes the keys from the api as well as deletes the local files!!!!</span>
|
|
```bash
|
|
tofu destroy -auto-approve
|
|
```
|
|
|
|
|