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
DigitalOcean | Carbon | Description |
---|
Account | Profile | Default token is pulled from the DIGITALOCEAN_TOKEN environment variable, or from the doctl config file |
Project | Environment | |
| | |
4 - GCloud Provider WIP
GCP Compute provider
This is a WIP
Map
GCP | Carbon | Description |
---|
Account | Profile | |
Project & Zone | Environment | |
| | |
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.