My Application v2 1
Application deployed via Humanitec Platform Orchestrator v2
Humanitec Platform Orchestrator v2
This application deploys to Humanitec Platform Orchestrator v2 on Azure AKS via Score.
Configuration
| Field | Value |
|---|---|
| Organization | skillful-wild-chicken-2617 |
| Project | demo-apps-1 |
| Default Environment | dev |
| Humanitec Console | Open |
Environments
| Environment | Namespace | Trigger |
|---|---|---|
dev |
dev |
Every push to main (when default env is dev) |
staging |
staging |
Manual workflow_dispatch → select staging |
prod |
prod |
Manual workflow_dispatch → select prod |
To promote to staging or prod, use the Run workflow button in the Gitea Actions UI and select the target environment.
Score Manifest (score.yaml)
Defines the workload — containers, ports, and external resource dependencies. Resources are resolved by the Humanitec platform at deploy time:
resources:
env: # type: environment — injects env vars
# blob: # type: azure-blob — Azure Blob Storage container
# config: # type: azure-keyvault-secret — Key Vault secret
# db: # type: postgres — Azure PostgreSQL database
CI/CD Workflow
Deployments are automated via Gitea Actions (.gitea/workflows/deploy.yml):
- Install hctl — downloads the Humanitec v2 CLI from
humanitec/hctl - Deploy — runs
hctl score deploy <project> <env> score.yaml - Humanitec runner applies the Terraform module on AKS, creating/updating K8s Deployment + Service
The HUMANITEC_TOKEN secret must be set in the Gitea repository (done automatically by the Backstage template).
Local Development
# Run locally with Docker
docker run -p 8080:80 nginx:alpine
Manual Deployment
To deploy manually using hctl:
# Authenticate
export HUMANITEC_TOKEN="your-service-user-token"
# Deploy to dev environment
hctl score deploy demo-apps-1 dev \\
--file score.yaml \\
--message "Manual deployment" \\
--token "$HUMANITEC_TOKEN"
View Deployment
Access the Humanitec v2 console: