io.github.cdklabs.cdkecsserviceextensions.FirelensMutatingHook Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of cdk-ecs-service-extensions Show documentation
The CDK Construct Library that helps you build ECS services using simple extensions
There is a newer version: 2.0.1-alpha.507
Show newest version
package io.github.cdklabs.cdkecsserviceextensions;

/**
 * (experimental) This hook modifies the application container's settings so that it routes logs using FireLens.
 */
@javax.annotation.Generated(value = "jsii-pacmak/1.103.1 (build bef2dea)", date = "2024-09-27T00:29:46.238Z")
@software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental)
@software.amazon.jsii.Jsii(module = io.github.cdklabs.cdkecsserviceextensions.$Module.class, fqn = "@aws-cdk-containers/ecs-service-extensions.FirelensMutatingHook")
public class FirelensMutatingHook extends io.github.cdklabs.cdkecsserviceextensions.ContainerMutatingHook {

    protected FirelensMutatingHook(final software.amazon.jsii.JsiiObjectRef objRef) {
        super(objRef);
    }

    protected FirelensMutatingHook(final software.amazon.jsii.JsiiObject.InitializationMode initializationMode) {
        super(initializationMode);
    }

    /**
     * @param props This parameter is required.
     */
    @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental)
    public FirelensMutatingHook(final @org.jetbrains.annotations.NotNull io.github.cdklabs.cdkecsserviceextensions.FirelensProps props) {
        super(software.amazon.jsii.JsiiObject.InitializationMode.JSII);
        software.amazon.jsii.JsiiEngine.getInstance().createNewObject(this, new Object[] { java.util.Objects.requireNonNull(props, "props is required") });
    }

    /**
     * (experimental) This is a hook for modifying the container definition of any upstream containers.
     * 
     * This is primarily used for the main application container.
     * For example, the Firelens extension wants to be able to modify the logging
     * settings of the application container.
     * 

     * @param props This parameter is required.
     */
    @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental)
    @Override
    public @org.jetbrains.annotations.NotNull software.amazon.awscdk.services.ecs.ContainerDefinitionOptions mutateContainerDefinition(final @org.jetbrains.annotations.NotNull software.amazon.awscdk.services.ecs.ContainerDefinitionOptions props) {
        return software.amazon.jsii.Kernel.call(this, "mutateContainerDefinition", software.amazon.jsii.NativeType.forClass(software.amazon.awscdk.services.ecs.ContainerDefinitionOptions.class), new Object[] { java.util.Objects.requireNonNull(props, "props is required") });
    }

    /**
     * (experimental) A fluent builder for {@link io.github.cdklabs.cdkecsserviceextensions.FirelensMutatingHook}.
     */
    @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental)
    public static final class Builder implements software.amazon.jsii.Builder {
        /**
         * @return a new instance of {@link Builder}.
         */
        @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental)
        public static Builder create() {
            return new Builder();
        }

        private final io.github.cdklabs.cdkecsserviceextensions.FirelensProps.Builder props;

        private Builder() {
            this.props = new io.github.cdklabs.cdkecsserviceextensions.FirelensProps.Builder();
        }

        /**
         * (experimental) The log group into which logs should be routed.
         * 

         * @return {@code this}
         * @param logGroup The log group into which logs should be routed. This parameter is required.
         */
        @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental)
        public Builder logGroup(final software.amazon.awscdk.services.logs.LogGroup logGroup) {
            this.props.logGroup(logGroup);
            return this;
        }

        /**
         * (experimental) The parent service that is being mutated.
         * 
         * @return {@code this}
         * @param parentService The parent service that is being mutated. This parameter is required.
         */
        @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental)
        public Builder parentService(final io.github.cdklabs.cdkecsserviceextensions.Service parentService) {
            this.props.parentService(parentService);
            return this;
        }

        /**
         * @return a newly built instance of {@link io.github.cdklabs.cdkecsserviceextensions.FirelensMutatingHook}.
         */
        @software.amazon.jsii.Stability(software.amazon.jsii.Stability.Level.Experimental)
        @Override
        public io.github.cdklabs.cdkecsserviceextensions.FirelensMutatingHook build() {
            return new io.github.cdklabs.cdkecsserviceextensions.FirelensMutatingHook(
                this.props.build()
            );
        }
    }
}