cdk-gitlab-runner 2.1.394 → 2.2.1

package/.jsii

@@ -6,6 +6,9 @@
       "author"
     ]
   },
+  "bundled": {
+    "compare-versions": "^6.1.0"
+  },
   "dependencies": {
     "aws-cdk-lib": "^2.86.0",
     "constructs": "^10.0.5"
@@ -3496,7 +3499,7 @@
   },
   "name": "cdk-gitlab-runner",
   "readme": {
-    "markdown": "[![NPM version](https://badge.fury.io/js/cdk-gitlab-runner.svg)](https://badge.fury.io/js/cdk-gitlab-runner)\n[![PyPI version](https://badge.fury.io/py/cdk-gitlab-runner.svg)](https://badge.fury.io/py/cdk-gitlab-runner)\n[![release](https://github.com/neilkuan/cdk-gitlab-runner/actions/workflows/release.yml/badge.svg)](https://github.com/neilkuan/cdk-gitlab-runner/actions/workflows/release.yml)\n\n![Downloads](https://img.shields.io/badge/-DOWNLOADS:-brightgreen?color=gray)\n![npm](https://img.shields.io/npm/dt/cdk-gitlab-runner?label=npm&color=orange)\n![PyPI](https://img.shields.io/pypi/dm/cdk-gitlab-runner?label=pypi&color=blue)\n\n![](https://img.shields.io/badge/iam_role_self-enable-green=?style=plastic&logo=appveyor)\n![](https://img.shields.io/badge/vpc_self-enable-green=?style=plastic&logo=appveyor)\n![](https://img.shields.io/badge/gitlab_url-customize-green=?style=plastic&logo=appveyor)\n![](https://img.shields.io/badge/spotfleet-runner-green=?style=plastic&logo=appveyor)\n\n# Welcome to `cdk-gitlab-runner`\nUse AWS CDK to create gitlab runner, and use [gitlab runner](https://gitlab.com/gitlab-org/gitlab-runner) to help you execute your Gitlab Pipeline Job.\n> GitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab. [(source repo)](https://gitlab.com/gitlab-org/gitlab-runner)\n\n## Why\nGitlab provides [400 minutes per month for each free user](https://about.gitlab.com/pricing/), hosted Gitlab Runner to execute your gitlab pipeline job.That's pretty good and users don't need to manage gitlab runner. If it is just a simple ci job for test 400, it may be enough.\nBut what if you want to deploy to your AWS production environment through pipeline job?\nIs there any security consideration for using the hosted gitlab runner?!\n\nBut creating Gitlab Runner is not that simple, so I created this OSS so that you can quickly create Gitlab Runner and delete your Gitlab Runner via AWS CDK.\nIt will be used with AWS IAM Role, so you don't need to put AKSK in Gitlab environment variables.\n\n![](./image/cdk-gitlab-runner.png)\n\n\n## Note\n### Default will help you generate below services:\n\n- VPC\n  - Public Subnet (2)\n- EC2 (1 T3.micro)\n\n## Before start you need gitlab runner token in your `gitlab project` or `gitlab group`\n\n### In Group\n\nGroup > Settings > CI/CD\n![group](image/group_runner_page.png)\n\n### In Project\n\nProject > Settings > CI/CD > Runners\n![project](image/project_runner_page.png)\n\n## Usage\n\nReplace your gitlab runner token in `$GITLABTOKEN`\n\n## Install\nUse the npm dist tag to opt in CDKv1 or CDKv2:\n```bash\n// for CDKv2\nnpm install cdk-gitlab-runner\nor\nnpm install cdk-gitlab-runner@latest\n\n// for CDKv1\nnpm install cdk-gitlab-runner@cdkv1\n```\n\n## 💡💡💡 please click [here](https://github.com/neilkuan/cdk-gitlab-runner/tree/cdkv1#readme), if you are using aws-cdk v1.x.x version.💡💡💡\n\n### Instance Type\n\n```typescript\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\n// If want change instance type to t3.large .\nnew GitlabContainerRunner(this, 'runner-instance', { gitlabtoken: '$GITLABTOKEN', ec2type:'t3.large' });\n// OR\n// Just create a gitlab runner , by default instance type is t3.micro .\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\nnew GitlabContainerRunner(this, 'runner-instance', { gitlabtoken: '$GITLABTOKEN' });})\n```\n\n### Gitlab Server Customize Url .\n\nIf you want change what you want tag name .\n\n```typescript\n// If you want change  what  your self Gitlab Server Url .\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\nnew GitlabContainerRunner(this, 'runner-instance-change-tag', {\n  gitlabtoken: '$GITLABTOKEN',\n  gitlaburl: 'https://gitlab.my.com/',\n});\n```\n\n### Tags\n\nIf you want change what you want tag name .\n\n```typescript\n// If you want change  what  you want tag name .\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\nnew GitlabContainerRunner(this, 'runner-instance-change-tag', {\n  gitlabtoken: '$GITLABTOKEN',\n  tags: ['aa', 'bb', 'cc'],\n});\n```\n\n### IAM Policy\n\nIf you want add runner other IAM Policy like s3-readonly-access.\n\n```typescript\n// If you want add runner other IAM Policy like s3-readonly-access.\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\nimport { ManagedPolicy } from 'aws-cdk-lib/aws-iam';\n\nconst runner = new GitlabContainerRunner(this, 'runner-instance-add-policy', {\n  gitlabtoken: '$GITLABTOKEN',\n  tags: ['aa', 'bb', 'cc'],\n});\nrunner.runnerRole.addManagedPolicy(\n  ManagedPolicy.fromAwsManagedPolicyName('AmazonS3ReadOnlyAccess'),\n);\n```\n\n### Security Group\n\nIf you want add runner other SG Ingress .\n\n```typescript\n// If you want add runner other SG Ingress .\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\nimport { Port, Peer } from 'aws-cdk-lib/aws-ec2';\n\nconst runner = new GitlabContainerRunner(this, 'runner-add-SG-ingress', {\n  gitlabtoken: 'GITLABTOKEN',\n  tags: ['aa', 'bb', 'cc'],\n});\n\n// you can add ingress in your runner SG .\nrunner.defaultRunnerSG.connections.allowFrom(\n  Peer.ipv4('0.0.0.0/0'),\n  Port.tcp(80),\n);\n```\n\n### Use self VPC\n\n> 2020/06/27 , you can use your self exist VPC or new VPC , but please check your `vpc public Subnet` Auto-assign public IPv4 address must be Yes ,or `vpc private Subnet` route table associated `nat gateway` .\n\n```typescript\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\nimport { Port, Peer, Vpc, SubnetType } from 'aws-cdk-lib/aws-ec2';\nimport { ManagedPolicy } from 'aws-cdk-lib/aws-iam';\n\nconst newvpc = new Vpc(stack, 'VPC', {\n  ipAddresses: IpAddresses.cidr('10.0.0.0/16'),\n  maxAzs: 2,\n  subnetConfiguration: [\n    {\n      cidrMask: 26,\n      name: 'RunnerVPC',\n      subnetType: SubnetType.PUBLIC,\n    },\n  ],\n  natGateways: 0,\n});\n\nconst runner = new GitlabContainerRunner(this, 'testing', {\n  gitlabtoken: '$GITLABTOKEN',\n  ec2type: 't3.small',\n  selfvpc: newvpc,\n});\n```\n\n### Use your self exist role\n\n> 2020/06/27 , you can use your self exist role assign to runner\n\n```typescript\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\nimport { Port, Peer } from 'aws-cdk-lib/aws-ec2';\nimport { ManagedPolicy, Role, ServicePrincipal } from 'aws-cdk-lib/aws-iam';\n\nconst role = new Role(this, 'runner-role', {\n  assumedBy: new ServicePrincipal('ec2.amazonaws.com'),\n  description: 'For Gitlab EC2 Runner Test Role',\n  roleName: 'TestRole',\n});\n\nconst runner = new GitlabContainerRunner(stack, 'testing', {\n  gitlabtoken: '$GITLAB_TOKEN',\n  ec2iamrole: role,\n});\nrunner.runnerRole.addManagedPolicy(\n  ManagedPolicy.fromAwsManagedPolicyName('AmazonS3ReadOnlyAccess'),\n);\n```\n\n### Custom Gitlab Runner EBS szie\n\n> 2020/08/22 , you can change you want ebs size.\n\n```typescript\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\nnew GitlabContainerRunner(stack, 'testing', {\n  gitlabtoken: '$GITLAB_TOKEN',\n  ebsSize: 50,\n});\n```\n\n### Control the number of runners with AutoScalingGroup\n\n> 2020/11/25 , you can set the number of runners.\n\n```typescript\nimport { GitlabRunnerAutoscaling } from 'cdk-gitlab-runner';\n\nnew GitlabRunnerAutoscaling(stack, 'testing', {\n  gitlabToken: '$GITLAB_TOKEN',\n  minCapacity: 2,\n  maxCapacity: 2,\n});\n```\n\n### Support Spotfleet Gitlab Runner\n\n> 2020/08/27 , you can use spotfleet instance be your gitlab runner,\n> after create spotfleet instance will auto output instance id.\n\n```typescript\nimport { GitlabContainerRunner, BlockDuration } from 'cdk-gitlab-runner';\n\nconst runner = new GitlabContainerRunner(stack, 'testing', {\n  gitlabtoken: 'GITLAB_TOKEN',\n  ec2type: 't3.large',\n  spotFleet: true,\n});\n// configure the expiration after 1 hours\nrunner.expireAfter(Duration.hours(1));\n```\n\n> 2020/11/19, you setting job runtime bind host volumes.\n> see more https://docs.gitlab.com/runner/configuration/advanced-configuration.html#the-runnersdocker-section\n\n```typescript\nimport { GitlabContainerRunner, BlockDuration } from 'cdk-gitlab-runner';\n\nconst runner = new GitlabContainerRunner(stack, 'testing', {\n  gitlabtoken: 'GITLAB_TOKEN',\n  ec2type: 't3.large',\n  dockerVolumes: [\n    {\n      hostPath: '/tmp/cache',\n      containerPath: '/tmp/cache',\n    },\n  ],\n});\n```\n\n## Wait about 6 mins , If success you will see your runner in that page .\n\n![runner](image/group_runner2.png)\n\n#### you can use tag `gitlab` , `runner` , `awscdk` ,\n\n## Example _`gitlab-ci.yaml`_\n\n[gitlab docs see more ...](https://docs.gitlab.com/ee/ci/yaml/README.html)\n\n```yaml\ndockerjob:\n  image: docker:18.09-dind\n  variables:\n  tags:\n    - runner\n    - awscdk\n    - gitlab\n  variables:\n    DOCKER_TLS_CERTDIR: \"\"\n  before_script:\n    - docker info\n  script:\n    - docker info;\n    - echo 'test 123';\n    - echo 'hello world 1228'\n```\n\n### If your want to debug you can go to aws console\n\n# `In your runner region !!!`\n\n## AWS Systems Manager > Session Manager > Start a session\n\n![system manager](image/session.png)\n\n#### click your `runner` and click `start session`\n\n#### in the brower console in put `bash`\n\n```bash\n# become to root\nsudo -i\n\n# list runner container .\nroot# docker ps -a\n\n# modify gitlab-runner/config.toml\n\nroot# cd /home/ec2-user/.gitlab-runner/ && ls\nconfig.toml\n```\n\n\n## :clap:  Supporters\n[![Stargazers repo roster for @neilkuan/cdk-gitlab-runner](https://reporoster.com/stars/neilkuan/cdk-gitlab-runner)](https://github.com/neilkuan/cdk-gitlab-runner/stargazers)\n"
+    "markdown": "[![NPM version](https://badge.fury.io/js/cdk-gitlab-runner.svg)](https://badge.fury.io/js/cdk-gitlab-runner)\n[![PyPI version](https://badge.fury.io/py/cdk-gitlab-runner.svg)](https://badge.fury.io/py/cdk-gitlab-runner)\n[![release](https://github.com/neilkuan/cdk-gitlab-runner/actions/workflows/release.yml/badge.svg)](https://github.com/neilkuan/cdk-gitlab-runner/actions/workflows/release.yml)\n\n![Downloads](https://img.shields.io/badge/-DOWNLOADS:-brightgreen?color=gray)\n![npm](https://img.shields.io/npm/dt/cdk-gitlab-runner?label=npm&color=orange)\n![PyPI](https://img.shields.io/pypi/dm/cdk-gitlab-runner?label=pypi&color=blue)\n\n![](https://img.shields.io/badge/iam_role_self-enable-green=?style=plastic&logo=appveyor)\n![](https://img.shields.io/badge/vpc_self-enable-green=?style=plastic&logo=appveyor)\n![](https://img.shields.io/badge/gitlab_url-customize-green=?style=plastic&logo=appveyor)\n![](https://img.shields.io/badge/spotfleet-runner-green=?style=plastic&logo=appveyor)\n\n# Welcome to `cdk-gitlab-runner`\nUse AWS CDK to create gitlab runner, and use [gitlab runner](https://gitlab.com/gitlab-org/gitlab-runner) to help you execute your Gitlab Pipeline Job.\n> GitLab Runner is the open source project that is used to run your CI/CD jobs and send the results back to GitLab. [(source repo)](https://gitlab.com/gitlab-org/gitlab-runner)\n\n## Why\nGitlab provides [400 minutes per month for each free user](https://about.gitlab.com/pricing/), hosted Gitlab Runner to execute your gitlab pipeline job.That's pretty good and users don't need to manage gitlab runner. If it is just a simple ci job for test 400, it may be enough.\nBut what if you want to deploy to your AWS production environment through pipeline job?\nIs there any security consideration for using the hosted gitlab runner?!\n\nBut creating Gitlab Runner is not that simple, so I created this OSS so that you can quickly create Gitlab Runner and delete your Gitlab Runner via AWS CDK.\nIt will be used with AWS IAM Role, so you don't need to put AKSK in Gitlab environment variables.\n\n![](./image/cdk-gitlab-runner.png)\n\n\n## Note\n### Default will help you generate below services:\n\n- VPC\n  - Public Subnet (2)\n- EC2 (1 T3.micro)\n\n## Before start you need gitlab runner token in your `gitlab project` or `gitlab group`\n\n## In Group before Gitlab 15.10\nThis registration process is only supported in GitLab Runner 15.10 or later\nThis registration process is not supported in GitLab Runner 15.9 or earlier and only available as an experimental feature in GitLab Runner 15.10 and 15.11. You should upgrade to GitLab Runner 16.0 or later to use a stable version of this registration process. [Check this issue](https://github.com/neilkuan/cdk-gitlab-runner/issues/1796)\n\nGroup > Settings > CI/CD\n![group](image/group_runner_page.png)\n\n## In Group after Gitlab 15.10\nThis registration process is only supported in GitLab Runner 15.10 or later\nThis registration process is not supported in GitLab Runner 15.9 or earlier and only available as an experimental feature in GitLab Runner 15.10 and 15.11. You should upgrade to GitLab Runner 16.0 or later to use a stable version of this registration process. [Check this issue](https://github.com/neilkuan/cdk-gitlab-runner/issues/1796)\n\nGroup > Build > Runners\n![group](image/gitlab-runner-new-register.png)\n![group](image/gitlab-runner-new-register-1.png)\n![group](image/gitlab-runner-new-register-2.png)\n![group](image/gitlab-runner-new-register-3.jpg)\n\n\n### In Project before Gitlab 15.10\nThis registration process is only supported in GitLab Runner 15.10 or later\nThis registration process is not supported in GitLab Runner 15.9 or earlier and only available as an experimental feature in GitLab Runner 15.10 and 15.11. You should upgrade to GitLab Runner 16.0 or later to use a stable version of this registration process. [Check this issue](https://github.com/neilkuan/cdk-gitlab-runner/issues/1796)\n\nProject > Settings > CI/CD > Runners\n![project](image/project_runner_page.png)\n\n### In Project after Gitlab 15.10\nThis registration process is only supported in GitLab Runner 15.10 or later\nThis registration process is not supported in GitLab Runner 15.9 or earlier and only available as an experimental feature in GitLab Runner 15.10 and 15.11. You should upgrade to GitLab Runner 16.0 or later to use a stable version of this registration process. [Check this issue](https://github.com/neilkuan/cdk-gitlab-runner/issues/1796)\n\nProject > Settings > CI/CD > Runners\n![project](image/gitlab-runner-new-register-project.png)\n\n## Usage\n\nReplace your gitlab runner token in `$GITLABTOKEN`\n\n## Install\nUse the npm dist tag to opt in CDKv1 or CDKv2:\n```bash\n// for CDKv2\nnpm install cdk-gitlab-runner\nor\nnpm install cdk-gitlab-runner@latest\n\n// for CDKv1\nnpm install cdk-gitlab-runner@cdkv1\n```\n\n## 💡💡💡 please click [here](https://github.com/neilkuan/cdk-gitlab-runner/tree/cdkv1#readme), if you are using aws-cdk v1.x.x version.💡💡💡\n\n### Instance Type\n\n```typescript\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\n// If want change instance type to t3.large .\nnew GitlabContainerRunner(this, 'runner-instance', { gitlabtoken: 'glrt-GITLABTOKEN', ec2type:'t3.large',gitlabRunnerVersion: '15.10' });\n// OR\n// Just create a gitlab runner , by default instance type is t3.micro .\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\nnew GitlabContainerRunner(this, 'runner-instance', { gitlabtoken: 'glrt-GITLABTOKEN', gitlabRunnerVersion: '15.10' });\n```\n\n### Gitlab Server Customize Url .\n\nIf you want change what you want tag name .\n\n```typescript\n// If you want change  what  your self Gitlab Server Url .\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\nnew GitlabContainerRunner(this, 'runner-instance-change-tag', {\n  gitlabtoken: 'glrt-GITLABTOKEN',\n  gitlaburl: 'https://gitlab.my.com/',\n  gitlabRunnerVersion: '15.10'\n});\n```\n\n### Tags\n\nIf you want change what you want tag name .\n!!! Not support Gitlab Runner 15.10 and later !!!\n```typescript\n// If you want change  what  you want tag name .\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\nnew GitlabContainerRunner(this, 'runner-instance-change-tag', {\n  gitlabtoken: 'glrt-GITLABTOKEN',\n  gitlabRunnerVersion: '15.10',\n  tags: ['aa', 'bb', 'cc'],\n});\n```\n\n### IAM Policy\n\nIf you want add runner other IAM Policy like s3-readonly-access.\n\n```typescript\n// If you want add runner other IAM Policy like s3-readonly-access.\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\nimport { ManagedPolicy } from 'aws-cdk-lib/aws-iam';\n\nconst runner = new GitlabContainerRunner(this, 'runner-instance-add-policy', {\n  gitlabtoken: 'glrt-GITLABTOKEN',\n  gitlabRunnerVersion: '15.10',\n  tags: ['aa', 'bb', 'cc'],\n});\nrunner.runnerRole.addManagedPolicy(\n  ManagedPolicy.fromAwsManagedPolicyName('AmazonS3ReadOnlyAccess'),\n);\n```\n\n### Security Group\n\nIf you want add runner other SG Ingress .\n\n```typescript\n// If you want add runner other SG Ingress .\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\nimport { Port, Peer } from 'aws-cdk-lib/aws-ec2';\n\nconst runner = new GitlabContainerRunner(this, 'runner-add-SG-ingress', {\n  gitlabtoken: 'glrt-GITLABTOKEN',\n  gitlabRunnerVersion: '15.10',\n  tags: ['aa', 'bb', 'cc'],\n});\n\n// you can add ingress in your runner SG .\nrunner.defaultRunnerSG.connections.allowFrom(\n  Peer.ipv4('0.0.0.0/0'),\n  Port.tcp(80),\n);\n```\n\n### Use self VPC\n\n> 2020/06/27 , you can use your self exist VPC or new VPC , but please check your `vpc public Subnet` Auto-assign public IPv4 address must be Yes ,or `vpc private Subnet` route table associated `nat gateway` .\n\n```typescript\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\nimport { Port, Peer, Vpc, SubnetType } from 'aws-cdk-lib/aws-ec2';\nimport { ManagedPolicy } from 'aws-cdk-lib/aws-iam';\n\nconst newvpc = new Vpc(stack, 'VPC', {\n  ipAddresses: IpAddresses.cidr('10.0.0.0/16'),\n  maxAzs: 2,\n  subnetConfiguration: [\n    {\n      cidrMask: 26,\n      name: 'RunnerVPC',\n      subnetType: SubnetType.PUBLIC,\n    },\n  ],\n  natGateways: 0,\n});\n\nconst runner = new GitlabContainerRunner(this, 'testing', {\n  gitlabtoken: 'glrt-GITLABTOKEN',\n  gitlabRunnerVersion: '15.10',\n  ec2type: 't3.small',\n  selfvpc: newvpc,\n});\n```\n\n### Use your self exist role\n\n> 2020/06/27 , you can use your self exist role assign to runner\n\n```typescript\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\nimport { Port, Peer } from 'aws-cdk-lib/aws-ec2';\nimport { ManagedPolicy, Role, ServicePrincipal } from 'aws-cdk-lib/aws-iam';\n\nconst role = new Role(this, 'runner-role', {\n  assumedBy: new ServicePrincipal('ec2.amazonaws.com'),\n  description: 'For Gitlab EC2 Runner Test Role',\n  roleName: 'TestRole',\n});\n\nconst runner = new GitlabContainerRunner(stack, 'testing', {\n  gitlabtoken: 'glrt-GITLABTOKEN',\n  gitlabRunnerVersion: '15.10',\n  ec2iamrole: role,\n});\nrunner.runnerRole.addManagedPolicy(\n  ManagedPolicy.fromAwsManagedPolicyName('AmazonS3ReadOnlyAccess'),\n);\n```\n\n### Custom Gitlab Runner EBS szie\n\n> 2020/08/22 , you can change you want ebs size.\n\n```typescript\nimport { GitlabContainerRunner } from 'cdk-gitlab-runner';\n\nnew GitlabContainerRunner(stack, 'testing', {\n  gitlabtoken: 'glrt-GITLABTOKEN',\n  gitlabRunnerVersion: '15.10',\n  ebsSize: 50,\n});\n```\n\n### Control the number of runners with AutoScalingGroup\n\n> 2020/11/25 , you can set the number of runners.\n\n```typescript\nimport { GitlabRunnerAutoscaling } from 'cdk-gitlab-runner';\n\nnew GitlabRunnerAutoscaling(stack, 'testing', {\n  gitlabToken: 'glrt-GITLABTOKEN',\n  gitlabRunnerVersion: '15.10',\n  minCapacity: 2,\n  maxCapacity: 2,\n});\n```\n\n### Support Spotfleet Gitlab Runner\n\n> 2020/08/27 , you can use spotfleet instance be your gitlab runner,\n> after create spotfleet instance will auto output instance id.\n\n```typescript\nimport { GitlabContainerRunner, BlockDuration } from 'cdk-gitlab-runner';\n\nconst runner = new GitlabContainerRunner(stack, 'testing', {\n  gitlabToken: 'glrt-GITLABTOKEN',\n  gitlabRunnerVersion: '15.10',\n  ec2type: 't3.large',\n  spotFleet: true,\n});\n// configure the expiration after 1 hours\nrunner.expireAfter(Duration.hours(1));\n```\n\n> 2020/11/19, you setting job runtime bind host volumes.\n> see more https://docs.gitlab.com/runner/configuration/advanced-configuration.html#the-runnersdocker-section\n\n```typescript\nimport { GitlabContainerRunner, BlockDuration } from 'cdk-gitlab-runner';\n\nconst runner = new GitlabContainerRunner(stack, 'testing', {\n  gitlabToken: 'glrt-GITLABTOKEN',\n  gitlabRunnerVersion: '15.10',\n  ec2type: 't3.large',\n  dockerVolumes: [\n    {\n      hostPath: '/tmp/cache',\n      containerPath: '/tmp/cache',\n    },\n  ],\n});\n```\n\n## Wait about 6 mins , If success you will see your runner in that page .\n\n![runner](image/group_runner2.png)\n\n#### you can use tag `gitlab` , `runner` , `awscdk` ,\n> !!!!! Not Support Gitlab Runner after 15.10 and later\n## Example _`gitlab-ci.yaml`_\n\n[gitlab docs see more ...](https://docs.gitlab.com/ee/ci/yaml/README.html)\n\n```yaml\ndockerjob:\n  image: docker:18.09-dind\n  variables:\n  tags:\n    - runner\n    - awscdk\n    - gitlab\n  variables:\n    DOCKER_TLS_CERTDIR: \"\"\n  before_script:\n    - docker info\n  script:\n    - docker info;\n    - echo 'test 123';\n    - echo 'hello world 1228'\n```\n\n### If your want to debug you can go to aws console\n\n# `In your runner region !!!`\n\n## AWS Systems Manager > Session Manager > Start a session\n\n![system manager](image/session.png)\n\n#### click your `runner` and click `start session`\n\n#### in the brower console in put `bash`\n\n```bash\n# become to root\nsudo -i\n\n# list runner container .\nroot# docker ps -a\n\n# modify gitlab-runner/config.toml\n\nroot# cd /home/ec2-user/.gitlab-runner/ && ls\nconfig.toml\n```\n\n\n## :clap:  Supporters\n[![Stargazers repo roster for @neilkuan/cdk-gitlab-runner](https://reporoster.com/stars/neilkuan/cdk-gitlab-runner)](https://github.com/neilkuan/cdk-gitlab-runner/stargazers)\n"
   },
   "repository": {
     "type": "git",
@@ -3579,7 +3582,7 @@
         },
         "locationInModule": {
           "filename": "src/gitlab-runner-instance.ts",
-          "line": 339
+          "line": 308
         },
         "parameters": [
           {
@@ -3605,7 +3608,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/gitlab-runner-instance.ts",
-        "line": 302
+        "line": 271
       },
       "methods": [
         {
@@ -3615,7 +3618,7 @@
           },
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 602
+            "line": 579
           },
           "name": "createUserData",
           "parameters": [
@@ -3653,7 +3656,7 @@
           },
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 578
+            "line": 555
           },
           "name": "expireAfter",
           "parameters": [
@@ -3679,7 +3682,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 326
+            "line": 295
           },
           "name": "defaultRunnerSG",
           "type": {
@@ -3694,7 +3697,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 311
+            "line": 280
           },
           "name": "runnerEc2",
           "type": {
@@ -3709,7 +3712,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 306
+            "line": 275
           },
           "name": "runnerRole",
           "type": {
@@ -3724,7 +3727,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 336
+            "line": 305
           },
           "name": "spotFleetInstanceId",
           "type": {
@@ -3739,7 +3742,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 331
+            "line": 300
           },
           "name": "spotFleetRequestId",
           "type": {
@@ -3754,7 +3757,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 316
+            "line": 285
           },
           "name": "vpc",
           "type": {
@@ -3775,10 +3778,26 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/gitlab-runner-instance.ts",
-        "line": 47
+        "line": 50
       },
       "name": "GitlabContainerRunnerProps",
       "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Gitlab Runner version Please give me gitlab runner version."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/gitlab-runner-instance.ts",
+            "line": 55
+          },
+          "name": "gitlabRunnerVersion",
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -3790,7 +3809,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 57
+            "line": 65
           },
           "name": "gitlabtoken",
           "type": {
@@ -3808,7 +3827,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 207
+            "line": 176
           },
           "name": "concurrentJobs",
           "optional": true,
@@ -3828,7 +3847,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 278
+            "line": 247
           },
           "name": "dockerVolumes",
           "optional": true,
@@ -3852,7 +3871,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 186
+            "line": 155
           },
           "name": "ebsSize",
           "optional": true,
@@ -3871,7 +3890,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 118
+            "line": 126
           },
           "name": "ec2iamrole",
           "optional": true,
@@ -3890,7 +3909,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 79
+            "line": 87
           },
           "name": "ec2type",
           "optional": true,
@@ -3901,7 +3920,7 @@
         {
           "abstract": true,
           "docs": {
-            "default": "public.ecr.aws/gitlab/gitlab-runner:latest",
+            "default": "public.ecr.aws/gitlab/gitlab-runner:latest !!! <--- latest now > 16.0 Gitlab Runner version",
             "example": "new GitlabRunnerAutoscaling(stack, 'runner', { gitlabToken: 'GITLAB_TOKEN', gitlabRunnerImage: 'gitlab/gitlab-runner:alpine' });",
             "stability": "experimental",
             "summary": "Image URL of Gitlab Runner."
@@ -3909,7 +3928,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 68
+            "line": 76
           },
           "name": "gitlabRunnerImage",
           "optional": true,
@@ -3928,7 +3947,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 175
+            "line": 144
           },
           "name": "gitlaburl",
           "optional": true,
@@ -3946,7 +3965,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 231
+            "line": 200
           },
           "name": "instanceInterruptionBehavior",
           "optional": true,
@@ -3964,7 +3983,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 224
+            "line": 193
           },
           "name": "keyName",
           "optional": true,
@@ -3983,7 +4002,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 217
+            "line": 186
           },
           "name": "runnerDescription",
           "optional": true,
@@ -4002,7 +4021,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 101
+            "line": 109
           },
           "name": "selfvpc",
           "optional": true,
@@ -4021,7 +4040,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 197
+            "line": 166
           },
           "name": "spotFleet",
           "optional": true,
@@ -4029,77 +4048,18 @@
             "primitive": "boolean"
           }
         },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "- tag1: gitlab .",
-            "deprecated": "- use tags ['runner', 'gitlab', 'awscdk']",
-            "example": "new GitlabContainerRunner(stack, 'runner', { gitlabtoken: 'GITLAB_TOKEN', tag1: 'aa' });",
-            "stability": "deprecated",
-            "summary": "Gitlab Runner register tag1  ."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/gitlab-runner-instance.ts",
-            "line": 131
-          },
-          "name": "tag1",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "- tag2: awscdk .",
-            "deprecated": "- use tags ['runner', 'gitlab', 'awscdk']",
-            "example": "new GitlabContainerRunner(stack, 'runner', { gitlabtoken: 'GITLAB_TOKEN', tag2: 'bb' });",
-            "stability": "deprecated",
-            "summary": "Gitlab Runner register tag2  ."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/gitlab-runner-instance.ts",
-            "line": 144
-          },
-          "name": "tag2",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "- tag3: runner .",
-            "deprecated": "- use tags ['runner', 'gitlab', 'awscdk']",
-            "example": "new GitlabContainerRunner(stack, 'runner', { gitlabtoken: 'GITLAB_TOKEN', tag3: 'cc' });",
-            "stability": "deprecated",
-            "summary": "Gitlab Runner register tag3  ."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/gitlab-runner-instance.ts",
-            "line": 157
-          },
-          "name": "tag3",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
             "default": "- ['runner', 'gitlab', 'awscdk']",
+            "see": " - https://docs.gitlab.com/ee/ci/runners/new_creation_workflow.html",
             "stability": "experimental",
-            "summary": "tags for the runner."
+            "summary": "tags for the runner Unsupported Gitlab Runner 15.10 and later."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 164
+            "line": 133
           },
           "name": "tags",
           "optional": true,
@@ -4122,7 +4082,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 238
+            "line": 207
           },
           "name": "validUntil",
           "optional": true,
@@ -4141,7 +4101,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-instance.ts",
-            "line": 261
+            "line": 230
           },
           "name": "vpcSubnet",
           "optional": true,
@@ -4166,7 +4126,7 @@
         },
         "locationInModule": {
           "filename": "src/gitlab-runner-autoscaling.ts",
-          "line": 242
+          "line": 249
         },
         "parameters": [
           {
@@ -4192,7 +4152,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/gitlab-runner-autoscaling.ts",
-        "line": 215
+        "line": 222
       },
       "methods": [
         {
@@ -4202,7 +4162,7 @@
           },
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 473
+            "line": 482
           },
           "name": "createUserData",
           "parameters": [
@@ -4235,7 +4195,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 224
+            "line": 231
           },
           "name": "autoscalingGroup",
           "type": {
@@ -4250,7 +4210,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 219
+            "line": 226
           },
           "name": "instanceRole",
           "type": {
@@ -4265,7 +4225,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 234
+            "line": 241
           },
           "name": "securityGroup",
           "type": {
@@ -4280,7 +4240,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 239
+            "line": 246
           },
           "name": "topicAlarm",
           "type": {
@@ -4295,7 +4255,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 229
+            "line": 236
           },
           "name": "vpc",
           "type": {
@@ -4316,10 +4276,26 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/gitlab-runner-autoscaling.ts",
-        "line": 19
+        "line": 21
       },
       "name": "GitlabRunnerAutoscalingProps",
       "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Gitlab Runner version Please give me gitlab runner version."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/gitlab-runner-autoscaling.ts",
+            "line": 26
+          },
+          "name": "gitlabRunnerVersion",
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4330,7 +4306,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 26
+            "line": 33
           },
           "name": "gitlabToken",
           "type": {
@@ -4348,7 +4324,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 209
+            "line": 216
           },
           "name": "alarms",
           "optional": true,
@@ -4372,7 +4348,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 127
+            "line": 134
           },
           "name": "desiredCapacity",
           "optional": true,
@@ -4392,7 +4368,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 196
+            "line": 203
           },
           "name": "dockerVolumes",
           "optional": true,
@@ -4416,7 +4392,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 156
+            "line": 163
           },
           "name": "ebsSize",
           "optional": true,
@@ -4435,7 +4411,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 37
+            "line": 44
           },
           "name": "gitlabRunnerImage",
           "optional": true,
@@ -4454,7 +4430,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 145
+            "line": 152
           },
           "name": "gitlabUrl",
           "optional": true,
@@ -4473,7 +4449,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 87
+            "line": 94
           },
           "name": "instanceRole",
           "optional": true,
@@ -4492,7 +4468,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 48
+            "line": 55
           },
           "name": "instanceType",
           "optional": true,
@@ -4511,7 +4487,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 116
+            "line": 123
           },
           "name": "maxCapacity",
           "optional": true,
@@ -4530,7 +4506,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 105
+            "line": 112
           },
           "name": "minCapacity",
           "optional": true,
@@ -4548,7 +4524,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 94
+            "line": 101
           },
           "name": "spotInstance",
           "optional": true,
@@ -4566,7 +4542,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 134
+            "line": 141
           },
           "name": "tags",
           "optional": true,
@@ -4590,7 +4566,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 70
+            "line": 77
           },
           "name": "vpc",
           "optional": true,
@@ -4609,7 +4585,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/gitlab-runner-autoscaling.ts",
-            "line": 179
+            "line": 186
           },
           "name": "vpcSubnet",
           "optional": true,
@@ -4630,7 +4606,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/gitlab-runner-instance.ts",
-        "line": 284
+        "line": 253
       },
       "members": [
         {
@@ -4659,6 +4635,6 @@
       "symbolId": "src/gitlab-runner-instance:InstanceInterruptionBehavior"
     }
   },
-  "version": "2.1.394",
-  "fingerprint": "DlHrppI4E6/KJWm6qfNLH/rMmWQRTuIHoxwaoi29tMY="
+  "version": "2.2.1",
+  "fingerprint": "3p6uEN4TRlXbjK+opiRPx0+pc+nzvulFw1+OkKSu6qQ="
 }