The CDK Construct Library for AWS::ServiceCatalogAppRegistry
Project description
AWS ServiceCatalogAppRegistry Construct Library
---The APIs of higher level constructs in this module are experimental and under active development. They are subject to non-backward compatible changes or removal in any future version. These are not subject to the Semantic Versioning model and breaking changes will be announced in the release notes. This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.
AWS Service Catalog App Registry enables organizations to create and manage repositores of applications and associated resources.
Table Of Contents
The @aws-cdk/aws-servicecatalogappregistry
package contains resources that enable users to automate governance and management of their AWS resources at scale.
import aws_cdk.aws_servicecatalogappregistry_alpha as appreg
Application
An AppRegistry application enables you to define your applications and associated resources. The application name must be unique at the account level, but is mutable.
application = appreg.Application(self, "MyFirstApplication",
application_name="MyFirstApplicationName",
description="description for my application"
)
An application that has been created outside of the stack can be imported into your CDK app.
Applications can be imported by their ARN via the Application.fromApplicationArn()
API:
imported_application = appreg.Application.from_application_arn(self, "MyImportedApplication", "arn:aws:servicecatalog:us-east-1:012345678910:/applications/0aqmvxvgmry0ecc4mjhwypun6i")
Attribute Group
An AppRegistry attribute group acts as a container for user-defined attributes for an application. Metadata is attached in a machine-readble format to integrate with automated workflows and tools.
attribute_group = appreg.AttributeGroup(self, "MyFirstAttributeGroup",
attribute_group_name="MyFirstAttributeGroupName",
description="description for my attribute group", # the description is optional,
attributes={
"project": "foo",
"team": ["member1", "member2", "member3"],
"public": False,
"stages": {
"alpha": "complete",
"beta": "incomplete",
"release": "not started"
}
}
)
An attribute group that has been created outside of the stack can be imported into your CDK app.
Attribute groups can be imported by their ARN via the AttributeGroup.fromAttributeGroupArn()
API:
imported_attribute_group = appreg.AttributeGroup.from_attribute_group_arn(self, "MyImportedAttrGroup", "arn:aws:servicecatalog:us-east-1:012345678910:/attribute-groups/0aqmvxvgmry0ecc4mjhwypun6i")
Associations
You can associate your appregistry application with attribute groups and resources. Resources are CloudFormation stacks that you can associate with an application to group relevant stacks together to enable metadata rich insights into your applications and resources. A Cloudformation stack can only be associated with one appregistry application. If a stack is associated with multiple applications in your app or is already associated with one, CDK will fail at deploy time.
Associating application with an attribute group
You can associate an attribute group with an application with the associateAttributeGroup()
API:
# application: appreg.Application
# attribute_group: appreg.AttributeGroup
application.associate_attribute_group(attribute_group)
Associating application with a Stack
You can associate a stack with an application with the associateStack()
API:
# application: appreg.Application
app = App()
my_stack = Stack(app, "MyStack")
application.associate_stack(my_stack)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aws-cdk.aws-servicecatalogappregistry-alpha-2.24.1a0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 681931c11cf40089364111ffc4a65095bc9acfebaa271ab72ca171e53d0bd6a8 |
|
MD5 | 0689441e62c61c0f003905c559d9ece7 |
|
BLAKE2b-256 | e94900d5dae85378e5ba77418aabbaf2ddb450cdd935de1d1adbe699e0f66485 |
Hashes for aws_cdk.aws_servicecatalogappregistry_alpha-2.24.1a0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8cd2ec0aa6b69533d66739ca07c8badf73fc83abcdf36dba956307720f71bd74 |
|
MD5 | 666005b001339e1fec7d23a97ad65f4f |
|
BLAKE2b-256 | ea4023ba46973c6a37ba065f1f782927aa2dadefd2594e35a88e5cc72754fab4 |