Declare infrastructures

How to declare an infrastructure?

Declare basic settings

1. Navigate to the Infrastructures menu -> Click "Declare"

2. Name your infrastructure

3. Select the provider that will host the infrastructure from the list (AWS, Azure, OCI, On-Prem)

4. Fill-in the additional information required to deploy your instances to the selected cloud provider (each provider has its own settings, they are to be retrieved from your cloud provider, see sections below for more details)

5. Optional - Add any custom tag to your infrastructure (these tags will be applied to all servers pertaining to this infrastructure) Tags are key-value pairs applied to a resource to hold metadata about that resource. Servers inherit the tags from the infrastructure they belong to.

6. Click Save

AWS settings

• Region ID (the AWS region where instances pertaining to this infrastructure will be deployed) (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html)

• Security Group ID (your EC2 security group) (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/working-with-security-groups.html)

• Subnet ID : (your VPC subnet) (https://docs.aws.amazon.com/vpc/latest/userguide/configure-your-vpc.html)

Azure settings

• Resource group name

• Security group name

• Subnet name

• Subscription ID

• Virtual network name

OCI settings

For each setting, we've tried to help you find where to get the required information from OCI. This is just a guidance at the time of writing this documentation as menus from the OCI interface might change in time.

• Availability domain

  • OCI portal > Navigation menu > Compute (top left) > Instances > Availability domain (bottom of the page)

• Compartment ID

  • OCI portal > Navigation menu > Identity & Security > Compartments > Copy the OCID of your compartment

• Region ID

  • OCI portal > Click on your region (top right) > Get your region Identifier (ex: eu-zurich-1) See https://docs.oracle.com/en-us/iaas/Content/General/Concepts/regions.htm for more details
• Security list

  • Networking > Virtual Cloud networks > Select the appropriate compartment > Select the desired VCN > Select the desired subnet > Select your security list > Retrieve Security list OCID

  • See https://docs.oracle.com/en-us/iaas/Content/Network/Tasks/get-subnet.htm for more details
• Subnet ID

  • Networking > Virtual Cloud networks > Select the appropriate compartment > Select the desired VCN > Select the desired subnet > Retrieve Subnet OCID

  • See https://docs.oracle.com/en-us/iaas/Content/Network/Tasks/get-subnet.htm for more details

On-premises

• From the menu, navigate to "Infrastructures"

• Click the "declare" button

• Give a name to your infrastructure (⚠️ : "_" character is not supported in infrastructure names)
• Select your provider ("On premises" in the present example)

• Click "Save"

---