- Home
- Integration and extensions
- CI/CD
- Workload artefacts
-
- Overview
-
- Overview
- Deploy your Application
- Manage your Java application
- Migrate an Application
- Provision Amazon S3 Buckets
- Deploy an Amazon S3 Resource to production
- Scaffold a new Workload and create staging and prod Environments
- Update Resource Definitions for related Applications
- Use existing Terraform modules
- Provision a Redis cluster on AWS using Terraform
- Perform daily developer activities (debug, rollback, diffs, logs)
- Deploy ephemeral Environments
-
-
Workload artefacts
On this page
“Workload” artefacts contain a Score Workload specification which includes all the details required to launch your service.
Upload Score specification #
Whenever a new version of your Workload is ready, you can notify the Humanitec Platform Orchestrator by uploading the Score Workload specification to the artefact version endpoint. This notification can trigger an Artefact Automation Pipeline for automated deployment.
This is a high level operation where the Platform Orchestrator is determining which Pipelines have an artefact trigger for that Score artefact, and then triggering asynchronous deployments of that artefact.
You can add one of the commands below to your existing CI or CD pipeline. Refer to the CI/CD Overview for a reflection on integration points.
Set the following environment variables:
Variable | Example | Description |
---|---|---|
HUMANITEC_TOKEN |
lsakdjhcals |
An API token of a user with at least the Artefact Contributor role in the Organization |
HUMANITEC_ORG |
my-org |
The target Organization |
humctl create artefact-version \
--type workload \
--spec ./score.yaml \
--name myProject/myWorkloadArtefact \
--version 1.2.3 \
--ref refs/heads/main
curl https://api.humanitec.io/orgs/${HUMANITEC_ORG}/artefact-versions \
-H "Authorization: Bearer ${HUMANITEC_TOKEN}" \
-F type=workload \
-F name=myProject/myWorkloadArtefact \
-F [email protected] \
-F ref=refs/heads/main