Cloud Agent Update
Fractal Cloud Agents are deployed as containers within your cloud infrastructure. When a new agent version is released, you need to pull the updated image from the Fractal private registry and push it to your cloud provider's container registry, then update the running service.
Cloud provider guides
| Provider | Agent Runtime | Guide |
|---|---|---|
| Amazon Web Services | ECS (Fargate) | Task definition + service update |
| Microsoft Azure | App Service | Deployment Center image update |
| Google Cloud Platform | Cloud Run | Service revision update |
| Oracle Cloud Infrastructure | Container Instance | Container instance redeployment |
| Hetzner Cloud | Virtual Machine | Docker image update on VM |
Prerequisites
Install regctl
regctl is used to copy container images between registries without pulling them locally. Install it before proceeding:
# macOS
brew install regclient
# Linux (download binary)
curl -L https://github.com/regclient/regclient/releases/latest/download/regctl-linux-amd64 > regctl
chmod +x regctl
sudo mv regctl /usr/local/bin/
Authenticate with the Fractal private registry
You will have received a Personal Access Token (PAT) from the Fractal Cloud team. Use it to log in to the private Docker Hub registry:
docker login -u <FRACTAL_DOCKER_USERNAME>
When prompted, enter your PAT as the password.
Keep your PAT secure. Do not commit it to version control or share it in plain text. Use a secrets manager or CI/CD secret store for automation.
You also need to configure regctl to use the same credentials:
regctl registry login docker.io -u <FRACTAL_DOCKER_USERNAME> -p <FRACTAL_PAT>
Identify the new agent version
The Fractal Cloud team will communicate the new version tag (e.g., v2.5.0). Each cloud vendor has its own agent image:
| Cloud Provider | Image |
|---|---|
| AWS | yanchware/fractal.cloudagent.aws.container |
| Azure | yanchware/fractal.cloudagent.azure.container |
| GCP | yanchware/fractal.cloudagent.gcp.container |
| OCI | yanchware/fractal.cloudagent.oci.container |
| Hetzner | yanchware/fractal.cloudagent.hetzner.container |
Once authenticated and with the target version identified, follow the vendor-specific guide to complete the update.
Do not modify any other Fractal Cloud Agent resources during the update. Only update the container image as described in the vendor-specific guides.