Skip to content

Latest commit

 

History

History
54 lines (42 loc) · 3.28 KB

README.md

File metadata and controls

54 lines (42 loc) · 3.28 KB
Raw

Jenkins

There are two examples provided: Using-AVH-Module which uses AVH Python module and AVH-as-Jenkins-Node which creates a Jenkins node from AVH AMI.

Using AVH-Module

In this approach, it is used AVH Python module, which is build on top of AWS SDK, to drive the AVH process. The Jenkins node is just a caller for it. The actual work is done by an EC2 instance created by the AVH Python module. In other words, the Jenkins pipeline is just a light-weight front end having enough code to run the AVH Python module.

Content of Using-AVH-Module

  • jobDSL: Jenkins configuration as code to create the AVH Jenkins Job.
  • pipeline: Example of running AVH using AVH Python Module.

Dependencies

AWS Account

  • AWS IAM User is needed to be created in your AWS Account. See item 1 and 2.
  • A S3 Bucket is needed to store temporary files. No special requirement is needed.
  • Security Group with Ingress SSH port allowed.
  • IAM Instance Profile to be associated with the AVH EC2 instances. See item 3
  • Optional SSH Key is needed if you would like to debug on EC2.
  • Subnet Id needs to be informed with EC2 instance.

It is provided a Cloudformation (AWS Infrastructure as Code) yaml file which can create the required AWS Resources for AVH, please go to ./infrastructure/cloudformation folder

Jenkins plugins

Jenkins Credentials

  • AWS Credential for IAM User (AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY)
  • AWS SSH Private Key to be associated with the EC2 instance.

AVH-as-Jenkins-Node

In this example, it is created a Jenkins node from the AVH AMI. Jenkins node is connected by SSH in Jenkins Controller and the commands are executed directly to the EC2 instance (as a Jenkins Node in this case).

Content of Using-AVH-Module

  • configuration-as-code: Example of Amazon EC2 plugin code.
  • jobDSL: Jenkins configuration as code to create the AVH as Jenkins Node job.
  • pipeline: Example of running AVH as Jenkins Node.

Dependencies

AWS Account

  • AWS IAM User is needed to be created in your AWS Account. See item 1 and 2.
  • Security Group with Ingress SSH port allowed.
  • SSH Keys are needed to communicate with EC2 instance as Jenkins Nodes.
  • Subnet Id needs to be informed with EC2 instance.

It is provided a Cloudformation (AWS Infrastructure as Code) yaml file which can create the required AWS Resources for AVH, please go to ./infrastructure/cloudformation folder

Jenkins plugins

Jenkins Credentials

  • AWS Credential for IAM User (AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY)
  • AWS SSH Private Key to be associated with the EC2 instance.