feat: implements Foundry API server (#156)

Author: jmgilman

.gitignore

@@ -10,3 +10,5 @@ node_modules
 !/.vscode/launch.recommended.json
 !/.vscode/settings.recommended.json
 !/.vscode/tasks.recommended.json
+
+.env

cli/go.mod

@@ -4,7 +4,6 @@ go 1.23.0
 
 require (
 	cuelang.org/go v0.12.0
-	github.com/adrg/xdg v0.5.3
 	github.com/alecthomas/kong v0.9.0
 	github.com/aws/aws-sdk-go v1.55.5
 	github.com/aws/aws-sdk-go-v2 v1.32.6
@@ -44,6 +43,7 @@ require (
 	github.com/Masterminds/squirrel v1.5.4 // indirect
 	github.com/Microsoft/go-winio v0.6.2 // indirect
 	github.com/ProtonMail/go-crypto v1.0.0 // indirect
+	github.com/adrg/xdg v0.5.3 // indirect
 	github.com/antlr/antlr4/runtime/Go/antlr/v4 v4.0.0-20230219212500-1f9a474cc2dc // indirect
 	github.com/asaskevich/govalidator v0.0.0-20230301143203-a9d515a09cc2 // indirect
 	github.com/aws/aws-sdk-go-v2/credentials v1.17.38 // indirect

foundry/api/.env.example

@@ -0,0 +1,15 @@
+# Server configuration
+export HTTP_PORT=8080
+export SERVER_TIMEOUT=30s
+
+# Database configuration
+export DB_HOST=localhost
+export DB_PORT=5432
+export DB_USER=postgres
+export DB_PASSWORD=postgres
+export DB_NAME=releases
+export DB_SSLMODE=disable
+
+# Logging configuration
+export LOG_LEVEL=debug
+export LOG_FORMAT=text

foundry/api/Earthfile

@@ -20,7 +20,7 @@ src:
 
     CACHE --persist --sharing shared /go
 
-    COPY --dir cmd .
+    COPY --dir client cmd internal pkg .
     RUN go generate ./...
 
 check:
@@ -37,34 +37,55 @@ build:
     ARG version="0.0.0"
 
     ENV CGO_ENABLED=0
-    RUN go build -ldflags="-extldflags=-static -X main.version=$version" -o bin/foundry cmd/main.go
+    RUN go build -ldflags="-extldflags=-static -X main.version=$version" -o bin/foundry-api cmd/api/main.go
     RUN file bin/foundry
 
-    SAVE ARTIFACT bin/foundry foundry
+    SAVE ARTIFACT bin/foundry-api foundry-api
 
 test:
-    FROM +build
+    FROM earthly/dind:ubuntu-24.04-docker-27.3.1-1
 
-    RUN go test ./...
+    COPY docker-compose.yml .
+
+    WITH DOCKER \
+        --load foundry-api:latest=(+docker) \
+        --load foundry-api-test:latest=(+docker-test) \
+        --compose docker-compose.yml \
+        --service api \
+        --service postgres
+        RUN docker compose up api-test
+    END
+
+docker-test:
+    FROM +src
+
+    COPY --dir test .
+
+    ENTRYPOINT ["/usr/local/go/bin/go", "test", "-v", "./test/..."]
+    SAVE IMAGE foundry-api-test:latest
 
 docker:
     FROM debian:bookworm-slim
     WORKDIR /app
 
-    ARG container="foundry"
+    ARG container="foundry-api"
     ARG tag="latest"
     ARG version="dev"
 
     ARG TARGETOS
     ARG TARGETARCH
     ARG USERPLATFORM
 
+    RUN apt-get update && apt-get install -y curl postgresql-client
+
     COPY \
         --platform=$USERPLATFORM \
-        (+build/foundry \
+        (+build/foundry-api \
         --GOOS=$TARGETOS \
         --GOARCH=$TARGETARCH \
-        --version=$version) foundry
+        --version=$version) foundry-api
+    COPY --dir sql .
+    COPY entrypoint.sh .
 
-    ENTRYPOINT ["/app/foundry"]
+    ENTRYPOINT [ "/bin/bash", "/app/entrypoint.sh" ]
     SAVE IMAGE ${container}:${tag}

foundry/api/blueprint.cue

@@ -7,17 +7,21 @@ project: {
 				version: string | *"dev" @forge(name="GIT_TAG")
 			}
 		}
+
 		github: {
 			args: {
 				version: string | *"dev" @forge(name="GIT_TAG")
 			}
 		}
+
+		test: privileged: true
 	}
 	deployment: {
 		on: {
 			merge: {}
 			tag: {}
 		}
+
 		bundle: {
 			env: "shared-services"
 			modules: main: {
@@ -29,26 +33,100 @@ project: {
 							name: _ @forge(name="CONTAINER_IMAGE")
 							tag:  _ @forge(name="GIT_HASH_OR_TAG")
 						}
+
+						env: {
+							"HTTP_PORT": {
+								value: "8080"
+							}
+							"GIN_MODE": {
+								value: "debug"
+							}
+							"LOG_LEVEL": {
+								value: "debug"
+							}
+							"LOG_FORMAT": {
+								value: "json"
+							}
+							"DB_INIT": {
+								value: "true"
+							}
+							"DB_SSLMODE": {
+								value: "enable"
+							}
+							"DB_NAME": {
+								value: "foundry"
+							}
+							"DB_HOST": {
+								secret: {
+									name: "db"
+									key:  "host"
+								}
+							}
+							"DB_PORT": {
+								secret: {
+									name: "db"
+									key:  "port"
+								}
+							}
+							"DB_USER": {
+								secret: {
+									name: "db"
+									key:  "username"
+								}
+							}
+							"DB_PASSWORD": {
+								secret: {
+									name: "db"
+									key:  "password"
+								}
+							}
+							"DB_SUPER_USER": {
+								secret: {
+									name: "db-root"
+									key:  "username"
+								}
+							}
+							"DB_SUPER_PASSWORD": {
+								secret: {
+									name: "db-root"
+									key:  "password"
+								}
+							}
+						}
+
 						port: 8080
+
 						probes: {
-							liveness: path:  "/"
-							readiness: path: "/"
+							liveness: path:  "/healthz"
+							readiness: path: "/healthz"
 						}
 					}
+
 					service: {
 						targetPort: 8080
 						port:       8080
 					}
+
+					secrets: {
+						db: {
+							ref: "db/foundry"
+						}
+						"db-root": {
+							ref: "db/root_account"
+						}
+					}
 				}
 			}
 		}
 	}
+
 	release: {
 		docker: {
 			on: {
 				merge: {}
 				tag: {}
 			}
+
 			config: {
 				tag: _ @forge(name="GIT_HASH_OR_TAG")
 			}

foundry/api/client/alias.go

@@ -0,0 +1,39 @@
+package client
+
+import (
+	"context"
+	"fmt"
+	"net/http"
+)
+
+// CreateAlias creates a new alias for a release
+func (c *HTTPClient) CreateAlias(ctx context.Context, aliasName string, releaseID string) error {
+	path := fmt.Sprintf("/release/alias/%s", aliasName)
+
+	payload := struct {
+		ReleaseID string `json:"release_id"`
+	}{
+		ReleaseID: releaseID,
+	}
+
+	return c.do(ctx, http.MethodPost, path, payload, nil)
+}
+
+// DeleteAlias removes an alias
+func (c *HTTPClient) DeleteAlias(ctx context.Context, aliasName string) error {
+	path := fmt.Sprintf("/release/alias/%s", aliasName)
+	return c.do(ctx, http.MethodDelete, path, nil, nil)
+}
+
+// ListAliases retrieves all aliases for a release
+func (c *HTTPClient) ListAliases(ctx context.Context, releaseID string) ([]ReleaseAlias, error) {
+	path := fmt.Sprintf("/release/%s/aliases", releaseID)
+
+	var resp []ReleaseAlias
+	err := c.do(ctx, http.MethodGet, path, nil, &resp)
+	if err != nil {
+		return nil, err
+	}
+
+	return resp, nil
+}