Skip to content

ClusterApplication

This class encapsulates and extends the ROS resource type ALIYUN::CS::ClusterApplicationThe , which resource type deploys containerized applications.

Initializers

import ros_cdk_cs
ros_cdk_cs.ClusterApplication(
  scope: Construct,
  id: str,
  cluster_id: typing.Union[str, IResolvable],
  yaml_content: typing.Union[str, IResolvable],
  creation_mode: typing.Union[str, IResolvable] = None,
  default_namespace: typing.Union[str, IResolvable] = None,
  default_namespace_deletion: typing.Union[bool, IResolvable] = None,
  role_policy: typing.Union[str, IResolvable] = None,
  stage: typing.Union[str, IResolvable] = None,
  validation_mode: typing.Union[str, IResolvable] = None,
  wait_until: typing.Union[IResolvable, typing.List[typing.Union[IResolvable, WaitUntilProperty]]] = None,
  enable_resource_property_constraint: bool = None
)
Name Type Description
scope ros_cdk_core.Construct No description.
id str No description.
cluster_id typing.Union[str, ros_cdk_core.IResolvable] Property clusterId: The ID of the kubernetes cluster.
yaml_content typing.Union[str, ros_cdk_core.IResolvable] Property yamlContent: The yaml content of application.
creation_mode typing.Union[str, ros_cdk_core.IResolvable] Property creationMode: Creation modes include: - Normal: create new resources, will report error if already exists.
default_namespace typing.Union[str, ros_cdk_core.IResolvable] Property defaultNamespace: The default namespace for the application, default value is default.
default_namespace_deletion typing.Union[bool, ros_cdk_core.IResolvable] Property defaultNamespaceDeletion: Whether to delete the namespace specified by DefaultNamespace.
role_policy typing.Union[str, ros_cdk_core.IResolvable] Property rolePolicy: Before deploying the application, check the policies associated with the roles of the current user.
stage typing.Union[str, ros_cdk_core.IResolvable] Property stage: At what stage to run.
validation_mode typing.Union[str, ros_cdk_core.IResolvable] Property validationMode: Validation modes include: - Basic: basic validation, such as verifying the existence of a cluster.
wait_until typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, WaitUntilProperty]]] Property waitUntil: After starting a creation or update, wait until all conditions are met.
enable_resource_property_constraint bool No description.

scopeRequired

  • Type: ros_cdk_core.Construct

idRequired

  • Type: str

cluster_idRequired

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property clusterId: The ID of the kubernetes cluster.


yaml_contentRequired

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property yamlContent: The yaml content of application.


creation_modeOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property creationMode: Creation modes include: - Normal: create new resources, will report error if already exists.

  • Apply: similar to kubectl apply, create if not exists, update if exists. During the deletion phase, ROS will delete newly created application, but updated existing application will not be deleted.

default_namespaceOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property defaultNamespace: The default namespace for the application, default value is default.

If a namespace is defined in yaml metadata, its priority is higher than DefaultNamespace. If the DefaultNamespace does not exist, ROS will create it automatically and keep it by default during the delete phase.


default_namespace_deletionOptional

  • Type: typing.Union[bool, ros_cdk_core.IResolvable]

Property defaultNamespaceDeletion: Whether to delete the namespace specified by DefaultNamespace.

If DefaultNamespace is in ('default', 'kube-node-lease', 'kube-public', 'kube-system', 'arms-prom'), no matter whether DefaultNamespaceDeletion is true or not, it will not be deleted.


role_policyOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property rolePolicy: Before deploying the application, check the policies associated with the roles of the current user.

Valid values:

  • EnsureAdminRoleAndBinding: Automatically create a role named "ros:application-admin:${user-id}" with administrator permissions and bind it to the current user.
  • None: Do nothing. The default value is EnsureAdminRoleAndBinding.

stageOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property stage: At what stage to run.

Valid values:

  • All: all stages, including create, update, and delete.
  • Delete: the delete stage. This means that only in the deletion stage of this resource will apply yaml to the cluster. The default is All.

validation_modeOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Property validationMode: Validation modes include: - Basic: basic validation, such as verifying the existence of a cluster.

  • Strict: in addition to basic validation, also validate the legality of YamlContent and WaitUntil.

wait_untilOptional

  • Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, WaitUntilProperty]]]

Property waitUntil: After starting a creation or update, wait until all conditions are met.


enable_resource_property_constraintOptional

  • Type: bool

Methods

Name Description
to_string Returns a string representation of this construct.
synthesize Allows this construct to emit artifacts into the cloud assembly during synthesis.
add_condition No description.
add_count No description.
add_dependency No description.
add_resource_desc No description.
apply_removal_policy No description.
fetch_condition No description.
fetch_dependency No description.
fetch_resource_desc No description.
get_att No description.
set_metadata No description.

to_string

def to_string() -> str

Returns a string representation of this construct.

synthesize

def synthesize(
  session: ISynthesisSession
) -> None

Allows this construct to emit artifacts into the cloud assembly during synthesis.

This method is usually implemented by framework-level constructs such as Stack and Asset as they participate in synthesizing the cloud assembly.

sessionRequired

  • Type: ros_cdk_core.ISynthesisSession

The synthesis session.


add_condition

def add_condition(
  condition: RosCondition
) -> None

conditionRequired

  • Type: ros_cdk_core.RosCondition

add_count

def add_count(
  count: typing.Union[typing.Union[int, float], IResolvable]
) -> None

countRequired

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

add_dependency

def add_dependency(
  resource: Resource
) -> None

resourceRequired

  • Type: ros_cdk_core.Resource

add_resource_desc

def add_resource_desc(
  desc: str
) -> None

descRequired

  • Type: str

apply_removal_policy

def apply_removal_policy(
  policy: RemovalPolicy
) -> None

policyRequired

  • Type: ros_cdk_core.RemovalPolicy

fetch_condition

def fetch_condition() -> RosCondition

fetch_dependency

def fetch_dependency() -> typing.List[str]

fetch_resource_desc

def fetch_resource_desc() -> str

get_att

def get_att(
  name: str
) -> IResolvable

nameRequired

  • Type: str

set_metadata

def set_metadata(
  key: str,
  value: typing.Any
) -> None

keyRequired

  • Type: str

valueRequired

  • Type: typing.Any

Static Functions

Name Description
is_construct Return whether the given object is a Construct.

is_construct

import ros_cdk_cs
ros_cdk_cs.ClusterApplication.is_construct(
  x: typing.Any
)

Return whether the given object is a Construct.

xRequired

  • Type: typing.Any

Properties

Name Type Description
node ros_cdk_core.ConstructNode The construct tree node associated with this construct.
env ros_cdk_core.IResourceEnvironment The environment this resource belongs to.
ref str No description.
stack ros_cdk_core.Stack The stack in which this resource is defined.
resource ros_cdk_core.RosResource No description.
attr_cluster_id typing.Union[str, ros_cdk_core.IResolvable] Attribute ClusterId: The ID of the cluster.
attr_wait_until_data typing.Union[str, ros_cdk_core.IResolvable] Attribute WaitUntilData: A list of values for each JsonPath in WaitUntil.
props ClusterApplicationProps No description.

nodeRequired

node: ConstructNode
  • Type: ros_cdk_core.ConstructNode

The construct tree node associated with this construct.


envRequired

env: IResourceEnvironment
  • Type: ros_cdk_core.IResourceEnvironment

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.


refRequired

ref: str
  • Type: str

stackRequired

stack: Stack
  • Type: ros_cdk_core.Stack

The stack in which this resource is defined.


resourceOptional

resource: RosResource
  • Type: ros_cdk_core.RosResource

attr_cluster_idRequired

attr_cluster_id: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Attribute ClusterId: The ID of the cluster.


attr_wait_until_dataRequired

attr_wait_until_data: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

Attribute WaitUntilData: A list of values for each JsonPath in WaitUntil.


propsRequired

props: ClusterApplicationProps