SDK Reference
The Fractal Cloud SDKs provide programmatic access to define, compose, and deploy infrastructure using code. They allow you to build reusable components, automate complex workflows, and integrate Fractal Cloud into your internal tools, CI/CD pipelines, and GitOps processes. By expressing infrastructure as code, you can version it alongside your application code, test it in lower environments, and apply the same software engineering practices you use for application development.
Available SDKs
| SDK | Language | Package | Repository |
|---|---|---|---|
| Java SDK | Java | fractal-java-sdk | Samples |
| TypeScript SDK | TypeScript / Node.js | @fractal_cloud/sdk | Samples |
| Terraform Provider | HCL | fractalcloud/fc | Samples |
The Java SDK has the broadest component coverage. The TypeScript SDK supports core infrastructure (IaaS), managed Kubernetes (AKS, GKE, EKS), and container workloads. The Terraform Provider manages Fractals (blueprints), Bounded Contexts, and Environments at the governance level. See individual component pages for SDK-specific availability.
This reference documents classes, methods, configuration options, and patterns across all SDKs. You'll find detailed information on every component type supported by Fractal Cloud — API gateways like Ambassador or Ocelot, Azure services (CDN, Relay, Service Bus, Storage, Web Apps), Kubernetes clusters with their workloads, databases like Postgres, plus observability solutions like Elasticsearch, Jaeger, Kafka, and Prometheus. Each component reference includes constructor parameters, method signatures, code examples, and explanations of how components interact with each other.
The SDKs are designed for infrastructure engineers, platform teams, and DevOps professionals who need fine-grained control plus repeatability. Use them when you want to encode organizational best practices into reusable modules, deploy infrastructure from code reviews, or manage large-scale setups where manual operations don't scale.
Start exploring
Ambassador
SDK reference for creating and managing Ambassador API Gateway components programmatically.
Azure CDN
Define and configure Azure Content Delivery Network resources using the SDK.
All resources
- Ambassador ‒ Create and manage Ambassador API Gateway components with routing, authentication, and rate limiting.
- Azure CDN ‒ Configure Azure Content Delivery Network for low-latency content distribution.
- Azure Relay ‒ Set up Azure Relay for secure hybrid connectivity between cloud and on-premises.
- Azure Service Bus ‒ Define Azure Service Bus messaging infrastructure with queues, topics, and subscriptions.
- Azure Storage Account ‒ Manage Azure Storage resources including blobs, files, queues, and tables.
- Azure Web App ‒ Deploy and configure Azure Web Apps for hosting web applications and APIs.
- Elastic Datastore ‒ Create and manage Elasticsearch clusters for search and analytics workloads.
- Elastic Logging ‒ Set up Elastic Stack (Elasticsearch, Logstash, Kibana) for centralized logging.
- Environment ‒ Define and manage deployment environments with variables, policies, and cloud connections.
- Jaeger ‒ Configure Jaeger for distributed tracing and microservices observability.
- Kafka ‒ Deploy and manage Apache Kafka messaging clusters for event streaming.
- Kubernetes Cluster ‒ Define Kubernetes cluster infrastructure with node pools and networking.
- Kubernetes Workload ‒ Deploy containerized workloads, services, and configurations to Kubernetes.
- Ocelot ‒ Configure Ocelot API Gateway for .NET microservices architectures.
- Postgres ‒ Deploy and manage PostgreSQL databases with high availability and backups.
- Prometheus ‒ Set up Prometheus for metrics collection, alerting, and monitoring dashboards.