Charmed-Kubernetes/kubernetes-worker/hooks/relations/aws-integration/docs/requires.md

requires

This is the requires side of the interface layer, for use in charms that wish to request integration with AWS native features. The integration will be provided by the AWS integration charm, which allows the requiring charm to not require cloud credentials itself and not have a lot of AWS specific API code.

The flags that are set by the requires side of this interface are:

• endpoint.{endpoint_name}.joined This flag is set when the relation has been joined, and the charm should then use the methods documented below to request specific AWS features. This flag is automatically removed if the relation is broken. It should not be removed by the charm.

• endpoint.{endpoint_name}.ready This flag is set once the requested features have been enabled for the AWS instance on which the charm is running. This flag is automatically removed if new integration features are requested. It should not be removed by the charm.

AWSIntegrationRequires Objects

class AWSIntegrationRequires(Endpoint)

Example usage:

from charms.reactive import when, endpoint_from_flag

@when('endpoint.aws.joined')
def request_aws_integration():
    aws = endpoint_from_flag('endpoint.aws.joined')
    aws.request_instance_tags({
        'tag1': 'value1',
        'tag2': None,
    })
    aws.request_load_balancer_management()
    # ...

@when('endpoint.aws.ready')
def aws_integration_ready():
    update_config_enable_aws()

instance_id

@property
def instance_id()

This unit's instance-id.

region

@property
def region()

The region this unit is in.

tag_instance

def tag_instance(tags)

Request that the given tags be applied to this instance.

Parameters

• tags (dict): Mapping of tag names to values (or None).

tag_instance_security_group

def tag_instance_security_group(tags)

Request that the given tags be applied to this instance's machine-specific security group (firewall) created by Juju.

Parameters

• tags (dict): Mapping of tag names to values (or None).

tag_instance_subnet

def tag_instance_subnet(tags)

Request that the given tags be applied to this instance's subnet.

Parameters

• tags (dict): Mapping of tag names to values (or None).

enable_acm_readonly

def enable_acm_readonly()

Request readonly for ACM.

enable_acm_fullaccess

def enable_acm_fullaccess()

Request fullaccess for ACM.

enable_instance_inspection

def enable_instance_inspection()

Request the ability to inspect instances.

enable_network_management

def enable_network_management()

Request the ability to manage networking (firewalls, subnets, etc).

enable_load_balancer_management

def enable_load_balancer_management()

Request the ability to manage load balancers.

enable_block_storage_management

def enable_block_storage_management()

Request the ability to manage block storage.

enable_dns_management

def enable_dns_management()

Request the ability to manage DNS.

enable_object_storage_access

def enable_object_storage_access(patterns=None)

Request the ability to access object storage.

Parameters

• patterns (list): If given, restrict access to the resources matching the patterns. If patterns do not start with the S3 ARN prefix
• __(arn__:aws:s3:::), it will be prepended.

enable_object_storage_management

def enable_object_storage_management(patterns=None)

Request the ability to manage object storage.

Parameters

• patterns (list): If given, restrict management to the resources matching the patterns. If patterns do not start with the S3 ARN
• __prefix (arn__:aws:s3:::), it will be prepended.