Metadata-Version: 2.1
Name: netunicorn-connector-aws
Version: 0.0.7
Summary: AWS connector for netunicorn
Author-email: Roman Beltiukov <rbeltiukov@ucsb.edu>
License: MIT
Keywords: netunicorn
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: netunicorn-base <0.5.0,>=0.4.0
Requires-Dist: pyyaml
Requires-Dist: boto3

# netunicorn-connector-aws
This is an AWS Fargate connector for netunicorn.

## How to use
This connector is supposed to be installed as a part of netunicorn-director-infrastructure package or container.

Install the package:
```bash
pip install netunicorn-connector-aws
```

Then, add the connector to the netunicorn-director-infrastructure configuration:
```yaml
  aws-fargate:  # unique name
    enabled: true
    module: "netunicorn.director.infrastructure.connectors.aws"  # where to import from
    class: "AWSFargate"  # class name
    config: "configuration-example.yaml"     # path to configuration file
```

Modify the configuration file to provide needed parameters (see [example](configuration-example.yaml)), such as
AWS credentials, region, etc.

## AWS configuration
You need to create an ECS cluster with Fargate as a provider type, e.g., according to this guide: https://docs.aws.amazon.com/AmazonECS/latest/userguide/create-cluster-console-v2.html

In the configuration file, please provide valid credentials, the correct region, and the cluster name.
