This document discusses AWS CodeDeploy, an automated deployment service that can deploy code to EC2 instances, on-premises servers, and Auto Scaling groups. It provides an example of using CodeDeploy to deploy a Ruby on Rails application from a GitHub repository to an Auto Scaling group. Key steps include configuring an appspec.yml file, IAM roles, and Auto Scaling launch configuration for the deployment process and creating a CodeDeploy application and deployment to trigger the deployment.

1. Is
the order
CodeDeploy?
Yoichi TOYOTA (@rs_wisteria)
Xtone Ltd.

2. agenda
● What is AWS CodeDeploy?
● CodeDeploy example
○ rails application

3. What is AWS CodeDeploy
● Automates code deployment to…
○ EC2 Instances
○ Instances running on-premises
● A File and Command-line based deployment
○ deploy any applicaton
○ reuse existing setup code
● and more issue
○ Healthcheck after deployment
○ rolling update
○ rollback
● https://aws.amazon.com/codedeploy/

4. example: rails application
● Deploy ruby on rails application from github
○ EC2 (Amazon linux)
○ Auto Scaling

5. example: rails application (cont.)
● Configure appspec.yml in Application
● Configure IAM Role
○ for CodeDeploy
○ for AutoScale
● Configure AutoScale Settings
○ create AMI
■ install rails prerequisite
■ install CodeDeploy Agent
○ create AutoScale group
● Create CodeDeploy Application
○ application
○ deploy group (for production, staging, etc.)
● Create deploy
○ configure github repository and revision

6. Configure appspec.yml in Application
● files
○ source-destination file mappings
● permissions
○ permission specification
● hooks
○ deployment lifecycle event mappings
■ ApplicationStop
■ BeforeInstall
■ AfterInstall
■ ApplicationStart
■ ValidateService
version: 0.0
os: linux
files:
- source: /
destination: /var/www/codedeploy-test
permissions:
- object: /var/www/codedeploy-test/logs
pattern: '**'
mode: 775
- object: /var/www/codedeploy-test/tmp
pattern: '**'
mode: 775
hooks:
AfterInstall:
- location: bin/bundle-install.sh
timeout: 300
runas: root

7. Create IAM Role
● for CodeDeploy
○ Attach “CodeDeployRole” policy
○ Trust ‘ec2.amazonaws.com’ and ‘codedeploy.amazonaws.com’
● for AutoScale
○ Attach custom policy allows ‘s3::Get’ and ‘s3::List’
○ Trust ‘ec2.amazonaws.com’

8. Configure AutoScale Settings
● Create AMI
○ install rails prerequisites
○ install CodeDeploy Agent
● Create AutoScale Launch Configuration
○ select AMI
○ select Instance Type
○ configure IAM Role for EC2 instance under AutoScale
○ other configurations for EC2 instance (security group, storage, etc.)
● Create AutoScale Group
○ select launch configuration
○ configure instance count
○ configure network
○ configure scaling policy

9. Create CodeDeploy application
● configure deploy target
○ Amazon EC2
○ Auto Scaling Group
○ On-premises Instance

10. Create CodeDeploy application (cont.)
● Configure deploy settings
○ OneAtTime
○ HalfAtTime
○ AllAtTime
● Configure IAM Role for
CodeDeploy

11. Create Deploy
● select application and deploy group
● configure source repository
○ github
○ S3
● select deploy settings
● and do deployment!

12. Deployment Completed!
● Gotcha!

13. Deploy on commit
● Create IAM user for github
○ allows CodeDeploy operations
● Configure github service
○ CodeDeploy Service
○ Github Auto-Deployment

14. Configure CodeDeploy Service on Github
● Project -> ‘Webhooks & services’
○ ‘AddService’ -> ‘AWS CodeDeploy’
● Configure below
○ CodeDeploy Application name
○ CodeDeploy deploy group
○ access key
○ secret access key
○ region

15. Configure Github Auto-Deployment
● Project -> ‘Webhooks & services’
○ ‘AddService’ -> ‘Github Auto-Deployment’
● Github token for deployment
● Deploy group as Environments

16. Done!
● Create deploy automatically!

17. And more
● We can deploy...
○ any application
■ php, nodejs, python, etc.
○ to On-premises Instances
■ independent of AWS EC2
○ from S3
■ independent of github