\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy1.jpg\")
<\/li>\n\nCodeDeploy Agent<\/li>\n
appspec.yml<\/code> file.<\/li>\n- Application is pulled from GitHub or S3<\/li>\n
- EC2 will run the deployment instructions<\/li>\n
- CodeDeploy Agent will report of success \/ failure of deployment on
\nthe instance<\/li>\n<\/ul>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy2.jpg\")
<\/p>\n
\n- EC2 instances are grouped by deployment group (dev \/ test \/ prod)<\/li>\n
- Lots of flexibility to define any kind of deployments<\/li>\n
- CodeDeploy can be chained into CodePipeline and use artifacts from
\nthere<\/li>\n - CodeDeploy can re-use existing setup tools, works with any application,
\nauto scaling integration<\/li>\n - Note: Blue \/ Green only works with EC2 instances (not on premise)<\/li>\n
- Support for AWS Lambda deployments, EC2<\/li>\n
- CodeDeploy does not provision resources<\/li>\n<\/ul>\n
<\/p>\n
EC2 Setup<\/span><\/p>\nBecause EC2 will read data from S3 we need to create and assign S3ReadOnly Role.<\/p>\n
IAM -> Create role -> EC2 -> AmazonS3ReadOnlyAccess -> Next -> Review -> Role Name (S3ReadOnly) -> Create role<\/code><\/p>\nFirst we need to launch EC2 instance.<\/p>\n
EC2 -> Launchh instance -> Amazon Linux 2 AMI (HVM), SSD Volume Type -> Select -> T2.micro -> Configure instance details -><\/code> <\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy3-1.jpg\")
<\/p>\n
You can use existing key pair and default security group.<\/p>\n
EC2 instance is running and we need to connect to it and install CodeDeploy agent. Choose your instance from list and click Connect<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy4-1.jpg\")
<\/p>\n
and then again Connect<\/code>.\u00a0![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy5-1.jpg\")
<\/p>\nAfter you connect to the instance run following commands:<\/p>\n
# Installing the CodeDeploy agent on EC2\r\n\r\nsudo yum update -y\r\nsudo yum install -y ruby wget\r\nwget https:\/\/aws-codedeploy-eu-west-1.s3.eu-west-1.amazonaws.com\/latest\/install\r\nchmod +x .\/install\r\nsudo .\/install auto\r\nsudo service codedeploy-agent status<\/pre>\nThis is the output:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy6.jpg\")
<\/p>\n
Codebuild agent has been installed and his proces id is 3857.<\/p>\n
We also need to give a tags to the instance:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy7.jpg\")
<\/p>\n
<\/p>\n
Application and Deployment Group<\/span><\/p>\nCreate Application -> Application name [CodeDeployDemo] -> Compute platform [EC2\/OnPremises] -> Create Application<\/code><\/p>\nFirst we need\u00a0 a role with CodeDeploy permissions that grants AWS CodeDeploy access to your target instances.<\/p>\n
IAM -> Roles -> Create role -> CodeDeploy (Allows CodeDeploy to call AWS services such as Auto Scaling on your behalf) -> Next: Permissions -> AWSCodeDeployRole -> Next -> Next -> Role name [CodeDeployRole] -> Create role<\/span><\/span><\/span><\/span><\/span><\/code><\/p>\nAlso we need S3 bucket where deployment puts files:<\/p>\n
C:\\Users\\mirth>aws configure --profile aws-devops\r\nAWS Access Key ID [None]: AKIA4HFREL3PLYD2XT7N\r\nAWS Secret Access Key [None]: 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\r\nDefault region name [None]: eu-central-1\r\nDefault output format [None]: json\r\n\r\nC:\\Users\\mirth>aws s3 mb s3:\/\/aws-devops-course-miro --region eu-central-1 --profile aws-devops\r\nmake_bucket: aws-devops-course-miro\r\n\r\nC:\\Users\\mirth>aws s3api put-bucket-versioning --bucket aws-devops-course-miro --versioning-configuration Status=Enabled --region eu-central-1 --profile aws-devops<\/pre>\nFrom inside my-webpage katalog we should zip and send files to the s3 bucket aws-devops-course-miro:<\/p>\n
C:\\Users\\mirth>d:\r\nD:\\>cd aws\r\nD:\\AWS>cd code\r\nD:\\AWS\\code>cd my-webpage\r\nD:\\AWS\\code\\my-webpage>dir\r\n Volume in drive D has no label.\r\n Volume Serial Number is 1DD6-4320\r\n\r\n Directory of D:\\AWS\\code\\my-webpage\r\n\r\n2021-02-08 12:47 <DIR> .\r\n2021-02-08 12:47 <DIR> ..\r\n2019-09-12 16:46 570 appspec.yml\r\n2019-09-12 16:46 501 buildspec.yml\r\n2019-09-12 16:46 754 CODEDEPLOY.md\r\n2019-09-12 16:46 717 index.html\r\n2021-02-08 12:47 <DIR> scripts\r\n 4 File(s) 2\u00a0542 bytes\r\n 3 Dir(s) 84\u00a0782\u00a0022\u00a0656 bytes free\r\n\r\nD:\\AWS\\code\\my-webpage>\r\n\r\nD:\\AWS\\code\\my-webpage>aws deploy push --application-name CodeDeployDemo --s3-location s3:\/\/aws-devops-course-miro\/codedeploy-demo\/app.zip --ignore-hidden-files --region eu-central-1 --profile aws-devops\r\nTo deploy with this revision, run:\r\naws deploy create-deployment --application-name CodeDeployDemo --s3-location bucket=aws-devops-course-miro,key=codedeploy-demo\/app.zip,bundleType=zip,eTag=5584c7b6bcad9c26a14492a3ecc773d0,version=QdMLpFvLcPUqvbB0mLlyNj6l0qIrhwAd --deployment-group-name <deployment-group-name> --deployment-config-name <deployment-config-name> --description <description>\r\n\r\nD:\\AWS\\code\\my-webpage><\/pre>\nAs we see in the s3 bucket aws-devops-course-miro we now have files:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy10.jpg\")
<\/p>\n
In order to create a new deployment, you must first create a deployment group.<\/p>\n
Create Deployment Group -> Deployment group name [MyDevelopmentInstances] -> Service role [CodeDeployRole] -> Deployment type [In Place] -> Environment Configuration -> Amazon EC2 Instances -> Key Value [Environment Development] -><\/code><\/p>\nWe have 1 unique matched instance.<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy8.jpg\")
<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy9.jpg\")
<\/p>\n
-> Deployment Configuration [CodeDeployDefaultAllAtOnce] -> Disable Load Balancing -> Create Deployment Group<\/code><\/p>\nDeployment group has been created and now we need a deployment.<\/p>\n
Create deployment -> Deployment group [MyDevelopmentInstances]<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy11.jpg\")
<\/p>\n
-> Create deployment<\/code>.<\/p>\nDeployment has been created.<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy12.jpg\")
<\/p>\n
And application is running on the EC2 instance.<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy13.jpg\")
<\/p>\n
<\/p>\n
Additional deployment groups<\/span><\/p>\nWe can launch more instances like which was launched before to create more deploment groups.<\/p>\n
EC2 -> Actions -> Image and templates -> Launch more like this -> Edit instance details -> Number of Instances [4] -> in User data -><\/code><\/p>\nsudo yum update -y\r\nsudo yum install -y ruby wget\r\nwget https:\/\/aws-codedeploy-eu-west-1.s3.eu-west-1.amazonaws.com\/latest\/install\r\nchmod +x .\/install\r\nsudo .\/install auto\r\nsudo service codedeploy-agent status\r\n<\/pre>\n-> Review and Launch -> Launch -> Choose key pair<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy14.jpg\")
<\/p>\n
Modify tags for three of running instances. Three instances must have “environment -> production” tags and two of them “development” tags.<\/p>\n
Go to the CodeDeploy and run new deployment group for application CodeDeployDemo.<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy17.jpg\")
<\/p>\n
The same role:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy18.jpg\")
<\/p>\n
Add to deployment group instances tagged as production:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy19.jpg\")
<\/p>\n
Remove load balancer and click on Create deployment group<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy20.jpg\")
<\/p>\n
Now we have 2 deployments group for application CodeDeployDemo<\/span><\/a>:<\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy21.jpg\")
<\/p>\n
Now let’s deploy the application o new deployment group:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy22.jpg\")
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy23.jpg\")
<\/p>\n
We have problem\u00a0 in deployment:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy24.jpg\")
<\/p>\n
So in the deplyments settings we need to change the configuration:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy25.jpg\")
<\/p>\n
After we change this setting we should again create deployment:<\/p>\n
<\/p>\n
<\/p>\n
Appspec.yml file.<\/span><\/p>\nOn the deployment we used such an appsppec.yml<\/code> file:<\/p>\nversion: 0.0\r\nos: linux\r\nfiles:\r\n - source: \/index.html\r\n destination: \/var\/www\/html\/\r\nhooks:\r\n ApplicationStop:\r\n - location: scripts\/stop_server.sh\r\n timeout: 300\r\n runas: root\r\n AfterInstall:\r\n - location: scripts\/after_install.sh\r\n timeout: 300\r\n runas: root\r\n BeforeInstall:\r\n - location: scripts\/install_dependencies.sh\r\n timeout: 300\r\n runas: root\r\n ApplicationStart:\r\n - location: scripts\/start_server.sh\r\n timeout: 300\r\n runas: root\r\n ValidateService:\r\n - location: scripts\/validate_service.sh\r\n timeout: 300\r\n<\/pre>\nFiles section means that de deploy will copy index.html<\/code> file to the \/var\/www\/html<\/code> destination.<\/p>\nApplicationStop hook:<\/p>\n
#!\/bin\/bash\r\nisExistApp=`pgrep httpd`\r\nif [[ -n $isExistApp ]]; then\r\n service httpd stop \r\nfi\r\n<\/pre>\nCheck if httpd proces is running. If yes the stop it.<\/p>\n
AfterInstall hook:<\/p>\n
#!\/bin\/bash\r\nEC2_INSTANCE_ID=$(curl -s http:\/\/169.254.169.254\/latest\/meta-data\/instance-id)\r\nEC2_AZ=$(curl -s http:\/\/169.254.169.254\/latest\/meta-data\/placement\/availability-zone)\r\nsed -i \"s\/was deployed\/was deployed on $EC2_INSTANCE_ID in $EC2_AZ\/g\" \/var\/www\/html\/index.html\r\nchmod 664 \/var\/www\/html\/index.html<\/pre>\nCopy instance id and instance availability zone from instance metadata. Puts info to the index.html<\/code> file.\u00a0 Change the permissons to the index.html file.<\/p>\nBeforeInstall hook:<\/p>\n
#!\/bin\/bash\r\nyum install -y httpd<\/pre>\nInstall apache server.<\/p>\n
ApplicationStart hook:<\/p>\n
#!\/bin\/bash\r\nservice httpd start<\/pre>\nStarts apache serwer.<\/p>\n
ValidateService hook:<\/p>\n
#!\/bin\/bash\r\n# verify we can access our webpage successfully\r\ncurl -v --silent localhost:80 2>&1 | grep Congratulations<\/pre>\nCheck if on the local web server there is “Congratulations” word.<\/p>\n
<\/p>\n
Monitoring deployments with Amazon CloudWatch Events<\/span><\/p>\nYou can use Amazon CloudWatch Events to detect and react to changes in the state of an instance or a deployment (an “event”) in your CodeDeploy operations.<\/p>\n
CloudWatch -> Events -> Rules -> Create rule<\/code><\/p>\nFirst you need to create a Lambda function to pass a notification to a Slack channel whenever deployments fail and then:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy28b.jpg\")
<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy28a.jpg\")
<\/p>\n
We can use CloudWatch alarm actions to automatically stop, terminate, reboot, or recover Amazon EC2 instances when a deployment or instance event you specify occurs.<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy29a.jpg\")
<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy29b.jpg\")
<\/p>\n
<\/p>\n
Monitoring deployments with SNS.<\/span><\/p>\nYou can add triggers to a CodeDeploy deployment group to receive notifications about events related to deployments or instances in that deployment group. These notifications are sent to recipients who are subscribed to an Amazon SNS topic you have made part of the trigger’s action.<\/p>\n
Developer Tools -> CodeDeploy -> Applications -> CodeDeployDemo -> MyProductionInstances -> Edit -> Advanced - optional -> Create Trigger<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy26.jpg\")
<\/p>\n
Create trigger -><\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy27.jpg\")
<\/p>\n
Save Changes -><\/code><\/p>\n <\/p>\n
Rollbacks.<\/span><\/p>\nYou can configure a deployment group or deployment to automatically roll back when a deployment fails or when a monitoring threshold you specify is met.<\/p>\n
Developer Tools -> CodeDeploy -> Applications -> CodeDeployDemo -> MyProductionInstances -> Edit -> Advanced - optional<\/code><\/p>\nIf we want to rollback only when a deploments fails we should use such a configuration:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy31.jpg\")
<\/p>\n
If we want to rollback based on alarm thresholds:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy30.jpg\")
<\/p>\n
We should create an CloudWatch alarm first:<\/p>\n
CloudWatch -> Alarms -> Create alarm -> Select metric -> EC2 -> Per instance -> CPUUtulization -> Select metric<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy32.jpg\")
<\/p>\n
Conditions -> Grater than 70 -> Next<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy33.jpg\")
<\/p>\n
Choose a SNS Topic:<\/p>\n
![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy34.jpg\")
<\/p>\n
Next -><\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy35.jpg\")
<\/p>\n
Create alarm -><\/code><\/p>\nAfter we have created an alarm we can add it to alarms:<\/p>\n
Add alarm -><\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy36.jpg\")
<\/p>\n
Add alarm -> X<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy37.jpg\")
<\/p>\n
If alarm goes up the deployment will be rolled back.<\/p>\n
Save changes -><\/code><\/p>\n <\/p>\n
On-Premise Instances Setup<\/span><\/p>\nAn on-premises instance have to run the CodeDeploy agent and connect to public AWS service endpoints.<\/p>\n
<\/p>\n
Deploy to AWS Lambda<\/span><\/p>\nDeveloper Tools -> CodeDeploy -> Applications -> Create application<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy38.jpg\")
<\/p>\n
-> Create application<\/code><\/p>\nNow we need to create a specific role for CodeDeploy to Lambda.<\/p>\n
IAM -> Roles -> Create role -> CodeDeploy -> CodeDeploy for Lambda -> Next: Permissions<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy39.jpg\")
<\/p>\n
Next: Tags -> Next: Review<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy40.jpg\")
<\/p>\n
Create role -><\/code><\/p>\nDeveloper Tools -> CodeDeploy -> Applications -> LambdaDeploymentApplication -> Create deployment group<\/code><\/p>\n![\"\"](\"http:\/\/miro.borodziuk.eu\/wp-content\/uploads\/CodeDeploy41.jpg\")
<\/p>\n
Create Deployment Group -><\/code><\/p>\n <\/p>\n
<\/p>\n
References
\n<\/strong><\/p>\n\n- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/APIReference\/API_MinimumHealthyHosts.html<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/reference-appspec-file-structure-hooks.html<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/reference-appspec-file-structure-hooks.html#appspec-hooks-server<\/a><\/li>\n
- https:\/\/docs.amazonaws.cn\/en_us\/codedeploy\/latest\/userguide\/reference-appspec-file-structure-hooks.html#reference-appspec-file-structure-environment-variable-availability<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/monitoring-cloudwatch-events.html<\/a><\/li>\n
- https:\/\/aws.amazon.com\/blogs\/devops\/view-aws-codedeploy-logs-in-amazon-cloudwatch-console\/<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/monitoring-sns-event-notifications.html<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/deployments-rollback-and-redeploy.html<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/deployment-groups-configure-advanced-options.html<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/instances-on-premises.html<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/register-on-premises-instance-iam-user-arn.html<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/register-on-premises-instance-iam-session-arn.html<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/deployment-configurations.html#deployment-configuration-lambda<\/a><\/li>\n
- https:\/\/docs.aws.amazon.com\/codedeploy\/latest\/userguide\/reference-appspec-file-structure-hooks.html#appspec-hooks-lambda<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"","protected":false},"author":1,"featured_media":3923,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[88],"tags":[],"_links":{"self":[{"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/posts\/3919"}],"collection":[{"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/comments?post=3919"}],"version-history":[{"count":35,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/posts\/3919\/revisions"}],"predecessor-version":[{"id":3927,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/posts\/3919\/revisions\/3927"}],"wp:featuredmedia":[{"embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/media\/3923"}],"wp:attachment":[{"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/media?parent=3919"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/categories?post=3919"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/miro.borodziuk.eu\/index.php\/wp-json\/wp\/v2\/tags?post=3919"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}