本文以TypeScript语言为例,为您介绍如何使用ROS CDK部署Nginx服务。

步骤一:初始化工程

执行以下命令,创建工程目录并初始化工程。

mkdir demo
cd demo
ros-cdk init --language=typescript --generate-only=true

步骤二:配置阿里云凭证信息

  1. 执行以下命令,配置阿里云凭证信息。
    ros-cdk config
  2. 根据界面提示输入配置信息。
    ros-cdk config
    endpoint(optional, default:https://ros.aliyuncs.com):
    defaultRegionId(optional, default:cn-hangzhou):cn-beijing
    
    [1] AK
    [2] StsToken
    [3] RamRoleArn
    [4] EcsRamRole
    [0] CANCEL
    
    Authenticate mode [1...4 / 0]: 1
    accessKeyId:************************
    accessKeySecret:******************************
    
     ✅ Your cdk configuration has been saved successfully!

步骤三:安装依赖

  1. 修改package.json文件,添加ECS依赖包(ros-cdk-ecs)。
    {
      "name": "demo",
      "version": "0.1.0",
      "bin": {
        "demo": "bin/demo.js"
      },
      "scripts": {
        "build": "tsc",
        "test": "jest"
      },
      "devDependencies": {
        "@types/jest": "^25.2.1",
        "@types/node": "10.17.5",
        "typescript": "^3.9.7",
        "jest": "^25.5.0",
        "ts-jest": "^25.3.1",
        "ts-node": "^8.1.0",
        "babel-jest": "^26.6.3",
        "@babel/core": "^7.12.9",
        "@babel/preset-env": "7.12.7",
        "@babel/preset-typescript": "^7.12.7",
        "@alicloud/ros-cdk-assert": "^1.0.0"
      },
      "dependencies": {
        "@alicloud/ros-cdk-core": "^1.0.5",
        "@alicloud/ros-cdk-ecs": "^1.0.3"
      }
    }
  2. 执行以下命令,安装依赖。
    npm install

步骤四:管理资源栈

  1. 修改lib/demo-stack.ts文件,创建ECS实例并安装Nginx服务。
    import * as ros from '@alicloud/ros-cdk-core';
    import * as ecs from '@alicloud/ros-cdk-ecs';
    import * as ROS from '@alicloud/ros-cdk-ros';
    
    export class DemoStack extends ros.Stack {
        constructor(scope: ros.Construct, id: string, props?: ros.StackProps) {
            super(scope, id, props);
            new ros.RosInfo(this, ros.RosInfo.description, "This is the simple ros cdk app example.");
            // The code that defines your stack goes here
            const nginxDefaultPort = new ros.RosParameter(this, 'NginxDefaultPort', {
                type: ros.RosParameterType.STRING,
            });
            const ecsInstanceType = new ros.RosParameter(this, 'EcsInstanceType', {
                type: ros.RosParameterType.STRING,
            });
            const systemDiskCategory = new ros.RosParameter(this, 'SystemDiskCategory', {
                type: ros.RosParameterType.STRING,
            });
            const vpc = new ecs.Vpc(this, 'vpc-from-ros-cdk', {
                vpcName: 'test-ros-cdk-vpc',
                cidrBlock: '10.0.0.0/8',
                description: 'This is ros cdk test'
            });
    
            const vsw = new ecs.VSwitch(this, `vsw-from-ros-cdk`, {
                vpcId: vpc.attrVpcId,
                // zoneId: ros.Fn.select(0, ros.Fn.getAzs(ros.Fn.ref('ALIYUN::Region'))),
                zoneId: 'cn-beijing-h',
                vSwitchName: 'test-ros-cdk-vsw',
                cidrBlock: '10.0.0.0/16',
            });
    
            const sg = new ecs.SecurityGroup(this, 'ros-cdk-test-sg',{
                vpcId: vpc.attrVpcId,
                securityGroupName: 'test-ros-cdk-sg',
                securityGroupIngress: [{'portRange':'22/22','nicType':'intranet','ipProtocol':'tcp','sourceCidrIp':'0.0.0.0/0'},
                    {'portRange':'80/80','nicType':'intranet','ipProtocol':'tcp','sourceCidrIp':'0.0.0.0/0'}]
            });
    
            const ecsWaitConditionHandle = new ROS.WaitConditionHandle(this,'RosWaitConditionHandle',{
                count: 1
            })
    
            const ecsWaitCondition = new ROS.WaitCondition(this,'RosWaitCondition',{
                timeout: 300,
                handle: ros.Fn.ref('RosWaitConditionHandle'),
                count: 1
            })
            let NginxDefaultPort = nginxDefaultPort.valueAsString
            const ecsGroups = new ecs.InstanceGroup(this,'ros-cdk-test-ecs',{
                vpcId: vpc.attrVpcId,
                vSwitchId: vsw.attrVSwitchId,
                imageId: 'centos_7',
                maxAmount: 1,
                securityGroupId: sg.attrSecurityGroupId,
                instanceType: ecsInstanceType.valueAsString,
                systemDiskCategory: systemDiskCategory.valueAsString,
                instanceName: 'test-ros-cdk-ecs',
                userData: ros.Fn.replace({ NOTIFY: ecsWaitConditionHandle.attrCurlCli }, `#!/bin/bash\nyum install -y nginx\nsed -i \'s/listen       80;/listen       ${NginxDefaultPort};/\' /etc/nginx/nginx.conf \nsystemctl restart nginx\n NOTIFY`),
            });
        }
    }
  2. 执行以下命令,生成模板文件。
    ros-cdk synth --json

    执行命令后,输出以下内容:

    {
      "Description": "This is the simple ros cdk app example.",
      "Metadata": {
        "ALIYUN::ROS::Interface": {
          "TemplateTags": [
            "Create by ROS CDK"
          ]
        }
      },
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "NginxDefaultPort": {
          "Type": "String"
        },
        "EcsInstanceType": {
          "Type": "String"
        },
        "SystemDiskCategory": {
          "Type": "String"
        }
      },
      "Resources": {
        "vpc-from-ros-cdk": {
          "Type": "ALIYUN::ECS::VPC",
          "Properties": {
            "CidrBlock": "10.0.0.0/8",
            "Description": "This is ros cdk test",
            "EnableIpv6": false,
            "VpcName": "test-ros-cdk-vpc"
          }
        },
        "vsw-from-ros-cdk": {
          "Type": "ALIYUN::ECS::VSwitch",
          "Properties": {
            "CidrBlock": "10.0.0.0/16",
            "VpcId": {
              "Fn::GetAtt": [
                "vpc-from-ros-cdk",
                "VpcId"
              ]
            },
            "ZoneId": "cn-beijing-h",
            "VSwitchName": "test-ros-cdk-vsw"
          }
        },
        "ros-cdk-test-sg": {
          "Type": "ALIYUN::ECS::SecurityGroup",
          "Properties": {
            "SecurityGroupIngress": [
              {
                "PortRange": "22/22",
                "SourceCidrIp": "0.0.0.0/0",
                "IpProtocol": "tcp",
                "NicType": "intranet"
              },
              {
                "PortRange": "80/80",
                "SourceCidrIp": "0.0.0.0/0",
                "IpProtocol": "tcp",
                "NicType": "intranet"
              }
            ],
            "SecurityGroupName": "test-ros-cdk-sg",
            "VpcId": {
              "Fn::GetAtt": [
                "vpc-from-ros-cdk",
                "VpcId"
              ]
            }
          }
        },
        "RosWaitConditionHandle": {
          "Type": "ALIYUN::ROS::WaitConditionHandle",
          "Properties": {
            "Count": 1,
            "Mode": "Full"
          }
        },
        "RosWaitCondition": {
          "Type": "ALIYUN::ROS::WaitCondition",
          "Properties": {
            "Handle": {
              "Ref": "RosWaitConditionHandle"
            },
            "Timeout": 300,
            "Count": 1
          }
        },
        "ros-cdk-test-ecs": {
          "Type": "ALIYUN::ECS::InstanceGroup",
          "Properties": {
            "ImageId": "centos_7",
            "InstanceType": {
              "Ref": "EcsInstanceType"
            },
            "MaxAmount": 1,
            "AllocatePublicIP": true,
            "AutoRenew": "False",
            "AutoRenewPeriod": 1,
            "InstanceChargeType": "PostPaid",
            "InstanceName": "test-ros-cdk-ecs",
            "InternetChargeType": "PayByTraffic",
            "InternetMaxBandwidthIn": 200,
            "InternetMaxBandwidthOut": 1,
            "IoOptimized": "optimized",
            "Period": 1,
            "PeriodUnit": "Month",
            "SecurityGroupId": {
              "Fn::GetAtt": [
                "ros-cdk-test-sg",
                "SecurityGroupId"
              ]
            },
            "SystemDiskCategory": {
              "Ref": "SystemDiskCategory"
            },
            "UserData": {
              "Fn::Replace": [
                {
                  "NOTIFY": {
                    "Fn::GetAtt": [
                      "RosWaitConditionHandle",
                      "CurlCli"
                    ]
                  }
                },
                {
                  "Fn::Join": [
                    "",
                    [
                      "#!/bin/bash\nyum install -y nginx\nsed -i 's/listen       80;/listen       ",
                      {
                        "Ref": "NginxDefaultPort"
                      },
                      ";/' /etc/nginx/nginx.conf \nsystemctl restart nginx\n NOTIFY"
                    ]
                  ]
                }
              ]
            },
            "VpcId": {
              "Fn::GetAtt": [
                "vpc-from-ros-cdk",
                "VpcId"
              ]
            },
            "VSwitchId": {
              "Fn::GetAtt": [
                "vsw-from-ros-cdk",
                "VSwitchId"
              ]
            }
          }
        }
      }
    }
  3. 执行以下命令,创建资源栈。
    ros-cdk deploy --parameters EcsInstanceType=ecs.c6e.large --parameters NginxDefaultPort=8080 --parameters SystemDiskCategory=cloud_essd --sync=true

    执行命令后,输出以下内容:

    DemoStack: deploying...
    |DemoStack               |2021-12-28T09:08:38 | CREATE_COMPLETE      | ALIYUN::ECS::SecurityGroup | sg-2ze515oc21n45wgs**** | ros-cdk-test-sg
    
    |DemoStack               |2021-12-28T09:08:38 | CREATE_COMPLETE      | ALIYUN::ECS::VSwitch    | vsw-2zeuuwgla2qqrw89**** | vsw-from-ros-cdk
    
    |DemoStack               |2021-12-28T09:08:38 | CREATE_COMPLETE      | ALIYUN::ROS::WaitConditionHandle |  | RosWaitConditionHandle
    
    |DemoStack               |2021-12-28T09:08:38 | CREATE_COMPLETE      | ALIYUN::ECS::VPC        | vpc-2zedbloxtm5jetdg**** | vpc-from-ros-cdk
    
    |DemoStack               |2021-12-28T09:08:38 | CREATE_COMPLETE      | ALIYUN::ECS::InstanceGroup | i-2ze6yjdmete88**** | ros-cdk-test-ecs
    
    |DemoStack               |2021-12-28T09:08:38 | CREATE_COMPLETE      | ALIYUN::ROS::WaitCondition |  | RosWaitCondition
    
    
     ✅ The deployment(sync deploy stack) has finished!
    status: CREATE_COMPLETE
    StatusReason: Stack CREATE completed successfully
    StackId: f7ddd89b-914a-44a4-aac9-80derdg****
  4. 可选:删除资源栈。
    1. 执行以下命令:
      ros-cdk destroy --sync=true
    2. 根据界面提示,确认删除。
      The following stack(s) will be destroyed(Only deployed stacks will be displayed).
      
      DemoStack
      
      Please confirm.(Y/N)
      y

      执行命令后,输出以下内容:

      DemoStack: destroying...
      |DemoStack               | DELETE_COMPLETE      | ALIYUN::ECS::SecurityGroup |  | ros-cdk-test-sg
      
      |DemoStack               | DELETE_COMPLETE      | ALIYUN::ECS::VSwitch    |  | vsw-from-ros-cdk
      
      |DemoStack               | DELETE_COMPLETE      | ALIYUN::ROS::WaitConditionHandle |  | RosWaitConditionHandle
      
      |DemoStack               | DELETE_COMPLETE      | ALIYUN::ECS::VPC        |  | vpc-from-ros-cdk
      
      |DemoStack               | DELETE_COMPLETE      | ALIYUN::ECS::InstanceGroup |  | ros-cdk-test-ecs
      
      |DemoStack               | DELETE_COMPLETE      | ALIYUN::ROS::WaitCondition |  | RosWaitCondition
      
      
       ✅ The task(sync destroy stack) has finished!
      status: DELETE_COMPLETE
      StatusReason: Stack DELETE completed successfully
      StackId: f7ddd89b-914a-44a4-aac9-80derdg****