> For the complete documentation index, see [llms.txt](https://dbi-services.gitbook.io/yak-user-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dbi-services.gitbook.io/yak-user-doc/manage-infrastructures/manage-infrastructure.md).

# 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**"

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://dbi-services.gitbook.io/yak-user-doc/manage-infrastructures/manage-infrastructure.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.