@dga-itc/aws-cdk-constructs 1.0.0

package/dist/aws-cdk/constructs/ecs-service.d.ts

@@ -0,0 +1,72 @@
+import { Construct } from 'constructs';
+import * as ec2 from 'aws-cdk-lib/aws-ec2';
+import * as ecs from 'aws-cdk-lib/aws-ecs';
+import * as elbv2 from 'aws-cdk-lib/aws-elasticloadbalancingv2';
+import * as logs from 'aws-cdk-lib/aws-logs';
+import { EcsServiceConfig } from '../interfaces/ecs-service-config';
+import { VpcConstruct } from './vpc';
+import { EcsClusterConstruct } from './ecs-cluster';
+import { AlbConstruct } from './alb';
+import { EfsConstruct } from './efs';
+import { RdsConstruct } from './rds';
+import { ElastiCacheConstruct } from './elasticache';
+export interface EcsServiceConstructProps {
+    config: EcsServiceConfig;
+    vpcConstruct: VpcConstruct;
+    ecsClusterConstruct: EcsClusterConstruct;
+    /** Required for web mode */
+    albConstruct?: AlbConstruct;
+    /** EFS construct - เปิด NFS port 2049 ที่ EFS SG */
+    efsConstruct?: EfsConstruct;
+    /** RDS construct - เปิด DB port ที่ RDS SG */
+    rdsConstruct?: RdsConstruct;
+    /** ElastiCache construct - เปิด Redis port ที่ Redis SG */
+    elastiCacheConstruct?: ElastiCacheConstruct;
+}
+/**
+ * ECS Service Construct - สร้าง Fargate Service + SecurityGroup + LogGroup + TargetGroup
+ *
+ * Modes:
+ * - web:    สร้าง TargetGroup + ListenerRule ที่ ALB
+ * - worker: สร้างแค่ Service (ไม่มี ALB integration)
+ *
+ * อ้างอิง VpcConstruct, EcsClusterConstruct, AlbConstruct จาก stacks อื่น
+ */
+export declare class EcsServiceConstruct extends Construct {
+    readonly service: ecs.FargateService;
+    readonly securityGroup: ec2.SecurityGroup;
+    readonly targetGroup?: elbv2.ApplicationTargetGroup;
+    readonly logGroup: logs.LogGroup;
+    readonly isWorkerMode: boolean;
+    private readonly removalPolicy;
+    constructor(scope: Construct, id: string, props: EcsServiceConstructProps);
+    /**
+     * เพิ่ม ingress rule ที่ EFS/RDS/Redis SG ให้ ECS SG เข้าถึงได้
+     * ใช้ CfnSecurityGroupIngress เพื่อหลีกเลี่ยง cyclic dependency
+     */
+    private setupUpstreamSecurityAccess;
+    private resolveVpc;
+    private createSecurityGroup;
+    private resolveIamRoles;
+    /**
+     * Apply preset policies ให้ Task Role
+     * ใช้ AWS Managed Policies เป็นหลัก, fallback เป็น inline สำหรับ services ที่ไม่มี managed policy ที่เหมาะสม
+     */
+    private applyTaskRolePresets;
+    /**
+     * Apply preset policies ให้ Execution Role
+     */
+    private applyExecutionRolePresets;
+    private createLogGroup;
+    private createTaskDefinition;
+    /**
+     * ถ้า image URL เป็น ECR pattern (*.dkr.ecr.*.amazonaws.com/repo:tag)
+     * ใช้ fromEcrRepository เพื่อให้ CDK auto-grant ECR pull policy
+     * ไม่งั้นใช้ fromRegistry ปกติ (Docker Hub, public ECR, etc.)
+     */
+    private resolveContainerImage;
+    private createFargateService;
+    private createTargetGroup;
+    private createListenerRule;
+    private createOutputs;
+}