SRE-final-project/ci/ghaymah_cli.md

Integrating with the ghaymah CLI

To manage and deploy applications to ghaymah.systems from your local machine or CI/CD pipeline, you need to use the ghaymah CLI.

1. Installation

Depending on your OS, install the CLI (example for macOS/Linux):

curl -sL https://cli.ghaymah.systems/install.sh | bash

2. Authentication

Log in to your ghaymah account:

ghaymah login

This will open a browser window to authenticate. If you are in a CI/CD environment (headless), use a token:

ghaymah login --token $GHAYMAH_TOKEN

3. Pushing Images to ghaymah Container Registry

Authenticate Docker with the ghaymah registry:

docker login registry.ghaymah.systems -u $GHAYMAH_USERNAME -p $GHAYMAH_TOKEN

Build and push your image:

docker build -t registry.ghaymah.systems/my-org/myapp-api:v1 .
docker push registry.ghaymah.systems/my-org/myapp-api:v1

4. Deploying the Application

Once the image is in the registry, deploy it using the CLI:

ghaymah deploy \
  --name myapp-api \
  --image registry.ghaymah.systems/my-org/myapp-api:v1 \
  --port 8080 \
  --env production

You can also monitor logs in real-time:

ghaymah logs myapp-api --follow