This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Providers

Providers help carbon work with various services.

Providers allow Carbon to interact with external applications to retrieve information about your operating environment.

By default, providers will automatically discover configuration profiles to use. You can disable the auto discovery and force enabled specific profiles.

carbon:
  providers:
    aws:
      auto_discover: false
      profiles:
        default:
          enabled: true

1 - AWS

AWS Provider for Carbon

The AWS provider uses AWS profiles as Platforms, VPCs as Environments, and EC2 instances as VMs. It will read your AWS config and return all of your profiles as platforms. Carbon does not use the AWS CLI directly, it is recommended to have it setup and configured especially if using SSO. Carbon will treat VPCs as environments.

Getting Started

Set up AWS CLI - aws config - aws sso con

RDP on mac requires windows app

2 - DigitalOcean WIP

DigitalOcean Provider for Carbon

This is a WIP, Missing Images and Image Builds

Map

DigitalOceanCarbonDescription
AccountProfileDefault token is pulled from the DIGITALOCEAN_TOKEN environment variable, or from the doctl config file
ProjectEnvironment

3 - Example Provider

Provider Boiler Plate

4 - GCloud Provider WIP

GCP Compute provider

This is a WIP

Map

GCPCarbonDescription
AccountProfile
Project & ZoneEnvironment

Configuration

use project/zone for the environment name.

carbon:
    providers:
        gcloud:
            profiles:
                default:
                    environments:
                      gcp-project/us-east3-c

5 - Multipass

Multpass provider

The Multipass provider is a simple wrapper around the Multipass executable. If Multipass is installed this provider will allow Carbon to interact with them. Since Multipass is on the local machine there is only one Profile returned (local) and one Environment returned (local).

6 - QEMU

QEMU via LibVirt

This provider uses the libvirt sdk by digital ocean. Currently, it is hardcoded to use qemu:///system, this should change in the future.

7 - VirtualBox

VirtualBox Provider

VirtualBox is an easy-to-use virtualization solution. It is also free. It is typically installed on your computer and allows you to create virtual machines for testing. Because of this, certain Carbon features will be static.

This provider is a simple wrapper around vbox-manage. If that is installed, it will allow you to interact with your VMs using Carbon.

8 - vSphere Provider WIP

VMWare vSphere

This is a WIP

Map

VSphereCarbonDescription
AccountProfileVsphere account
Host SystemEnvironment