Metadata-Version: 2.1
Name: cdk-gitlab-runner
Version: 1.0.1
Summary: A  Gitlab Runner JSII construct lib for AWS CDK
Home-page: https://github.com/guan840912/cdk-gitlab-runner.git
Author: Neil Guan <guan840912@gmail.com>
License: Apache-2.0
Project-URL: Source, https://github.com/guan840912/cdk-gitlab-runner.git
Description: [![NPM version](https://badge.fury.io/js/cdk-gitlab-runner.svg)](https://badge.fury.io/js/cdk-gitlab-runner)
        [![PyPI version](https://badge.fury.io/py/cdk-gitlab-runner.svg)](https://badge.fury.io/py/cdk-gitlab-runner)
        ![Release](https://github.com/guan840912/cdk-gitlab-runner/workflows/Release/badge.svg)
        
        # Welcome to `cdk-gitlab-runner`
        
        This repository template helps you create gitlab runner on your aws account via AWS CDK one line.
        
        ## Note
        
        ### Will help you generate below services:
        
        * VPC
        
          * Public Subnet (2)
        * EC2 (1 T3.large)
        
        ## Before start you need gitlab runner token in your  `gitlab project` or   `gitlab group`
        
        ### In Group
        
        Group > Settings > CI/CD
        ![group](image/group_runner_page.png)
        
        ### In Group
        
        Project > Settings > CI/CD > Runners
        ![project](image/project_runner_page.png)
        
        ## Usage
        
        Replace your gitlab runner token in `$GITLABTOKEN`
        
        ```python
        # Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
        from cdk_gitlab_runner import GitlabContainerRunner
        from aws_cdk.aws_ec2 import InstanceType, InstanceClass, InstanceSize
        # If want change instance type to t3.large .
        GitlabContainerRunner(stack, "testing", gitlabtoken="$GITLABTOKEN", ec2type=InstanceType.of(InstanceClass.T2, InstanceSize.LARGE))
        # OR
        # Just create a gitlab runner , by default instance type is t3.small .
        from cdk_gitlab_runner import GitlabContainerRunner
        from aws_cdk.aws_ec2 import InstanceType, InstanceClass, InstanceSize
        GitlabContainerRunner(stack, "testing", gitlabtoken="$GITLABTOKEN")
        
        # If want change tags you want.
        from cdk_gitlab_runner import GitlabContainerRunner
        from aws_cdk.aws_ec2 import InstanceType, InstanceClass, InstanceSize
        GitlabContainerRunner(stack, "testing-have-type-tag", gitlabtoken="GITLABTOKEN", tag1="aa", tag2="bb", tag3="cc")
        ```
        
        ```python
        # Example python instance type change to t3.small .
        GitlabContainerRunner(self, 'gitlab-runner', gitlabtoken='$GITLABTOKEN',
                                      ec2type=InstanceType.of(
                                          instance_class=InstanceClass.BURSTABLE3, instance_size=InstanceSize.SMALL), tag1='aa',tag2='bb',tag3='cc')
        ```
        
        ### see more instance class and size
        
        [InstanceClass](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.InstanceClass.html)
        
        [InstanceSize](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.InstanceSize.html)
        
        ## Wait about 6 mins , If success you will see your runner in that page .
        
        ![runner](image/group_runner2.png)
        
        #### you can use tag `gitlab` , `runner` , `awscdk`  ,
        
        ## Example     *`gitlab-ci.yaml`*
        
        [gitlab docs see more ...](https://docs.gitlab.com/ee/ci/yaml/README.html)
        
        ```yaml
        dockerjob:
          image: docker:18.09-dind
          variables:
          tags:
            - runner
            - awscdk
            - gitlab
          variables:
            DOCKER_TLS_CERTDIR: ""
          before_script:
            - docker info
          script:
            - docker info;
            - echo 'test 123';
            - echo 'hello world 1228'
        ```
        
        ### If your want to debug you can go to aws console
        
        # `In your runner region !!!`
        
        ## AWS Systems Manager  >  Session Manager  >  Start a session
        
        #### click your `runner` and click `start session`
        
        #### in the brower console in put `bash`
        
        ```bash
        # become to root
        sudo -i
        
        # list runner container .
        root# docker ps -a
        
        # modify gitlab-runner/config.toml
        
        root# cd /home/ec2-user/.gitlab-runner/ && ls
        config.toml
        
        ```
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Typing :: Typed
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved
Requires-Python: >=3.6
Description-Content-Type: text/markdown
