Integrating Cloud Accounts

Step-by-step guide to connecting AWS, Azure, GCP, and Kubernetes accounts to Facets by running a generated command in your cloud provider's shell.

Connect a cloud account so Facets can provision and launch environments on it. You can integrate Amazon Web Services, Microsoft Azure, Google Cloud Platform, and standalone Kubernetes clusters.

The raptor commands on this page are the Praxis CLI. See Install Praxis CLI to set it up.

How to add a cloud account in Facets

Using prompt

Link my AWS account to Facets and call it prod-aws.

or

Using command

raptor create account --provider aws --name prod-aws -w

--provider takes aws, gcp, azure or kubernetes. The command prints the same script the console modal shows, which you then run in a terminal already authenticated against that cloud. -w waits and reports when the link completes instead of exiting straight after printing.

# What is linked already, and of which kind
raptor get accounts --type CLOUD
raptor get account --name prod-aws -o json

New to the CLI? Install it first.

Go to Settings > Accounts, the page that lists every account and where you add new Cloud and VCS accounts. The console flow differs slightly per provider.

Microsoft Azure

  1. On the Accounts page, click Azure.
  2. Enter an Account Name and click Next.
  3. Copy the command generated in the modal.
  4. Open the Microsoft Azure Portal and click the Cloud Shell icon on the top bar.
  5. In the Cloud Shell terminal, run the command.
  6. Facets detects the connection automatically once it succeeds.
Walkthrough of adding an Azure account from the Accounts page in the Facets Control Plane

Google Cloud Platform (GCP)

  1. On the Accounts page, click GCP.
  2. Enter an Account Name and click Next.
  3. Copy the command generated in the modal.
  4. Open the GCP Cloud Console and click the Cloud Shell icon on the top bar.
  5. In the Cloud Shell terminal, run the command.
  6. Facets detects the connection automatically once it succeeds.
Walkthrough of adding a Google Cloud Platform account from the Accounts page in the Facets Control Plane

Amazon Web Services (AWS)

  1. On the Accounts page, click AWS.
  2. Enter an Account Name and click Next.
  3. Copy the command generated in the modal.
  4. Open the AWS Cloud Console and click the CloudShell icon on the top bar.
  5. In the CloudShell terminal, run the command.
  6. Facets detects the connection automatically once it succeeds.
Walkthrough of adding an AWS account from the Accounts page in the Facets Control Plane

Kubernetes

  1. On the Accounts page, click Kubernetes.
  2. Enter an Account Name and click Next.
  3. Copy the command generated in the modal.
  4. Load your kubeconfig in a terminal and run the command.
  5. Facets detects the connection automatically once it succeeds.
Walkthrough of adding a Kubernetes account from the Accounts page in the Facets Control Plane