# Declare infrastructures

## 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 (:warning: : "\_" character is not supported in infrastructure names)
* Select your provider ("**On premises**" in the present example)
* Click "**Save**"

***