Skip to main content

Quick Start

Getting started with Fractal Cloud is straightforward. We fully support Azure, GCP and AWS for all users.

Enterprise Customers

Integration with Oracle Cloud Infrastructure (OCI) and Hetzner is currently available for enterprise customers only.

Follow these steps to connect your cloud environment with Fractal Cloud and begin creating cloud infrastructure.

Prerequisites​

  • An active Azure, GCP or AWS Subscription with billing enabled.
  • Log in or Register a Fractal Cloud account.

Setup Process​

1. Create a Resource Group​

Begin by creating a Resource Group in Fractal Cloud. This group will organize all the resources required for your Fractals and LiveSystems.

2. Create an Environment​

Next, create an environment within Fractal Cloud. This environment acts as a workspace for your LiveSystems and Fractals, allowing you to manage your resources effectively.

3. Initialize the Cloud Agent​

Initialize the Fractal Cloud Agent in your Azure environment. This step sets up the necessary resources and generates crucial credentials for integration.

For detailed instructions, see the Fractal Cloud Agent Initialization Guide.

4. Create and Instantiate Your First Fractal​

With your environment and resource group ready, you can now create your first Fractal and instantiate it. This step brings your cloud infrastructure components to life.

5. SDK Usage​

To provision infrastructure components programmatically, you can use our Java SDK. For authentication, you'll need to retrieve specific secrets essential for authenticating your SDK-based applications with Fractal Cloud.

Azure, GCP, AWS Users

Retrieve the following secrets:

  • fractal-ci-cd-service-account-name: The Client Id
  • fractal-ci-cd-service-account-password: The Client Secret

For Amazon Web Services (AWS) customers, find these secrets in the AWS Secrets Manager within the selected Account.

For Google Cloud Platform (GCP) customers, these secrets are stored in the GCP Secret Manager of the selected Project.

For Azure, the necessary secrets can be found in the Azure Key Vault, created during the Cloud Agent initialization. These are located in a resource group named with the pattern rg-<environment_short_name>, where <environment_short_name> is defined during environment creation.

Enterprise Customers Using OCI or Hetzner

For OCI and Hetzner enterprise customers, the corresponding secrets will also be named:

  • fractal-ci-cd-service-account-name: The Client Id
  • fractal-ci-cd-service-account-password: The Client Secret

For Oracle Cloud Infrastructure (OCI) enterprise customers, these secrets are stored in the OCI Vault of the selected Tenancy.

For Hetzner enterprise customers, these secrets are stored in the Hetzner Secret Manager of the selected Project.

The secrets Id's for these credentials will be consistent across all cloud providers, ensuring a unified experience in using our Java SDK.

Our SDK package is publicly available for use. You can find both the SDK and a variety of examples demonstrating its usage in our repositories on GitHub:

Explore the SDK for detailed documentation and the samples for practical usage examples to get started with provisioning and managing your cloud infrastructure components efficiently.

Congratulations 🎉!

You've set up the basics. Now, you're ready to explore Fractal Cloud's features and start building amazing applications.

If you have any questions or need further assistance, please contact us.