# CLI Overview and Prequisites

#### Infrastructure as Code (IaC) Directory

When you convert a `.cloud` configuration, the CLI generates standardized infrastructure code in an `IaC` directory. This includes:

* Terraform configurations for cloud resources
* Kubernetes manifests for container orchestration
* Ansible playbooks for configuration management

#### File References

The CLI supports referencing external files within your `.cloud` configuration using the `file()` function. This is particularly useful for:

* IAM policies
* Configuration files
* Scripts
* Other JSON/YAML resources

Example:

```hcl
\\ .cloud file
iam "eks_cluster" {
  name               = "eks_cluster"
  assume_role_policy = file("role.json")
  resource_type      = "aws_iam_role"
}

\\ role.json
{
    "Version": "2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "eks.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
  }
```

### Prerequisites

Before using the Cloudscript CLI, ensure you have the following installed:

* Terraform (latest version recommended)
* Kubernetes CLI (kubectl)
* Ansible
* Python 3.6 or later
* Docker (for local testing)
* AWS CLI (configured with appropriate credentials)
* GCP CLI (if using Google Cloud Platform)

#### AWS Configuration

The CLI requires proper AWS credentials configuration. You can set this up by:

1. Installing the AWS CLI
2. Running `aws configure`
3. Providing your AWS access key ID and secret access key

#### GCP Configuration

For Google Cloud Platform:

1. Install the Google Cloud SDK
2. Run `gcloud auth login`
3. Set your default project with `gcloud config set project PROJECT_ID`

### Directory Structure

When working with Cloudscript, maintain the following directory structure for optimal operation:

```plaintext
project/
├── cloud/               # Cloud configuration directory
│   ├── main.cloud       # Main cloud configuration file
│   ├── role.json
│   └── other-configs/   # Other configuration files
└── IaC/                 # Generated infrastructure code (created by convert)
    ├── main.tf.json     
    ├── resources.yml
    ├── playbook.yml
    ├── inventory.yml
    └── .keys/
```