
<p>When we built AppDynamics almost ten years ago, the APM market laughed at us. &#8220;No way, heard all these claims before,&#8221; &#8220;You can’t do that, it&#8217;s cheating,&#8221;  &#8220;BS, no way you can monitor production in 4 minutes.&#8221; At that time, the monitoring market was littered with 30+ vendors and products, which, to be frank, weren&#8217;t up to the job. No wonder people didn&#8217;t believe in us.</p>



<p>If I told you that you could use Harness to build a fully automated canary deployment from scratch, in 4 minutes, would you believe me? Let&#8217;s give it a go and see what happens.<br><script src="https://fast.wistia.com/embed/medias/p9w6zbgmdj.jsonp" async=""></script><script src="https://fast.wistia.com/assets/external/E-v1.js" async=""></script></p>



<script src="https://fast.wistia.com/embed/medias/p9w6zbgmdj.jsonp" async></script><script src="https://fast.wistia.com/assets/external/E-v1.js" async></script><div class="wistia_responsive_padding" style="padding:56.25% 0 0 0;position:relative;"><div class="wistia_responsive_wrapper" style="height:100%;left:0;position:absolute;top:0;width:100%;"><div class="wistia_embed wistia_async_p9w6zbgmdj videoFoam=true" style="height:100%;position:relative;width:100%"><div class="wistia_swatch" style="height:100%;left:0;opacity:0;overflow:hidden;position:absolute;top:0;transition:opacity 200ms;width:100%;"><img src="https://fast.wistia.com/embed/medias/p9w6zbgmdj/swatch" style="filter:blur(5px);height:100%;object-fit:contain;width:100%;" alt="" aria-hidden="true" onload="this.parentNode.style.opacity=1;" /></div></div></div></div>



<p></p>



<p></p>



<h2>What is a Canary Deployment?</h2>



<p>Canary deployments basically reduce the scope, impact, and risk of deploying new software artifacts to production. Instead of deploying a new artifact across all production nodes at the same time, you deploy to a subset of those nodes in phases, with each phase verified to ensure artifacts and your application are behaving appropriately.</p>



<p>For example, you might have a 3-phase canary deployment across your production stack like this:</p>



<figure class="wp-block-image size-large"><img loading="lazy" width="836" height="262" src="https://blog.harness.io/wp-content/uploads/2022/01/3-Phase-Canary-Deployment.png" alt="Three-Phase Canary Deployment" class="wp-image-267745" srcset="https://blog.harness.io/wp-content/uploads/2022/01/3-Phase-Canary-Deployment.png 836w, https://blog.harness.io/wp-content/uploads/2022/01/3-Phase-Canary-Deployment-300x94.png 300w, https://blog.harness.io/wp-content/uploads/2022/01/3-Phase-Canary-Deployment-768x241.png 768w" sizes="(min-width: 960px) 75vw, 100vw" /></figure>



<p>After each deployment phase, you would verify the stability, performance, and quality of the artifact(s) and application before allowing the next deployment phase to execute. Most organizations today do this verification step manually with 4-6 engineers who each spend 30-60 minutes looking at monitoring tools and log files to make sure everything is OK.</p>



<p>In this blog, I’ll show you how you can automate this entire process in 5 minutes.</p>



<h2>Step 1: Create New Application</h2>



<p>Go to:<strong> Setup > Applications > Create New Application</strong></p>



<p>It should <strong>take you 10 seconds</strong> to create a new application (a logical group to manage services and artifacts).</p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="333" src="https://blog.harness.io/wp-content/uploads/2022/01/Create-Application.png" alt="Create New Application" class="wp-image-267746" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Create-Application.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Create-Application-300x143.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<h2>Step 2: Create New Service</h2>



<p>Obviously, we need something to deploy, so let&#8217;s create a new service.</p>



<p>Go to: <strong>Setup > Your Application > Add Service</strong></p>



<p>Enter <strong>My Microservice</strong> as the service name and choose <strong>Docker Image</strong> as the artifact type. Next, add the artifact source by referencing the specific artifact from your repository. <strong>This should take 20 seconds.</strong></p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="537" src="https://blog.harness.io/wp-content/uploads/2022/01/Add-Artifact.png" alt="Add Artifact" class="wp-image-267747" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Add-Artifact.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Add-Artifact-300x230.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<h2>Step 3: Create New Environment</h2>



<p>We now need somewhere to deploy our new service and artifact.</p>



<p>Go to: <strong>Setup > Your Application > Add Environment</strong></p>



<p>Name your environment <strong>Production</strong> and choose <strong>production</strong> as the environment type.</p>



<p>Next, click <strong>Add Service Infrastructure</strong>, select <strong>My Microservice</strong> as your service, and then select <strong>Amazon ECS</strong> as the deployment type (Harness also supports Kubernetes). Next, choose your Cloud Provider account, region, and desired cluster to deploy to. <strong>This process should take 20 seconds.</strong></p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="483" src="https://blog.harness.io/wp-content/uploads/2022/01/Create-Environment.png" alt="Create an Environment for your Canary Deployment" class="wp-image-267748" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Create-Environment.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Create-Environment-300x207.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<h2>Step 4: Create a Canary Workflow</h2>



<p>Workflows tell Harness how to deploy services to environments.</p>



<p>Go to: <strong>Setup > Your Application > Add Workflow </strong></p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="384" src="https://blog.harness.io/wp-content/uploads/2022/01/Add-Workflow.png" alt="Create a Workflow for Your Canary Deployment" class="wp-image-267749" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Add-Workflow.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Add-Workflow-300x165.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<p>Name your workflow. Select <strong>Canary Deployment</strong> as Workflow type and then select the environment you have just created (Production). This should <strong>take you 10 seconds.</strong></p>



<h2>Step 5: Create Pre-Deployment Steps</h2>



<p>You’ll now be presented with a workflow wizard that will guide you through your canary deployment setup. Let’s add a simple pre-deployment step that will notify us via email that the canary deployment is about to start.</p>



<p>Go to: <strong>+Add Step</strong> under <strong>Pre-Deployment Steps</strong> and select <strong>Email</strong></p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="442" src="https://blog.harness.io/wp-content/uploads/2022/01/Email.png" alt="Email Pre-Deployment Step" class="wp-image-267750" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Email.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Email-300x189.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<p>Enter details for fields <strong>To, Subject, and Body</strong>. This should <strong>take you 20 seconds.</strong> </p>



<p>Harness also gives you the option to invoke any 3rd party tools via HTTP REST in addition to native integration for things like Bamboo and Jenkins jobs, which you may want to kick off prior to any deployment.</p>



<h2>Step 6: Create Canary Deployment Phases</h2>



<p>Now comes the fun part. We get to play God and create canaries.</p>



<p>Let’s create a 3 phase canary deployment for our microservice that will deploy to 10%, 50%, and 100% of your environment respectively.</p>



<p>Click <strong>+Add Step</strong> under <strong>Deployment Phases</strong> to create Phase 1.</p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="421" src="https://blog.harness.io/wp-content/uploads/2022/01/Deploy-Phase.png" alt="Deploy Phase" class="wp-image-267751" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Deploy-Phase.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Deploy-Phase-300x180.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<p>Pick the <strong>My Microservice</strong> and <strong>Production</strong> environment that you have just created. <strong>This should take 5 seconds.</strong> Now click <strong>Upgrade Containers</strong> and enter the number of desired nodes (10%) you want to upgrade in phase 1. <strong>This should take 10 seconds.</strong></p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="467" src="https://blog.harness.io/wp-content/uploads/2022/01/Upgrade-Containers.png" alt="Upgrade Containers" class="wp-image-267752" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Upgrade-Containers.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Upgrade-Containers-300x200.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<p>We now need to specify how Harness is going to verify the service that is being deployed as part of the canary phase.</p>



<p>Click <strong>+Add Verification</strong> and pick your monitoring tool(s), which is going to provide Harness with the data it needs to verify your service once it has been deployed.</p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="361" height="400" src="https://blog.harness.io/wp-content/uploads/2022/01/Choose-Verification-Provider.png" alt="Choose Your Verification Provider" class="wp-image-267753" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Choose-Verification-Provider.png 361w, https://blog.harness.io/wp-content/uploads/2022/01/Choose-Verification-Provider-271x300.png 271w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<p>Harness has out-of-the-box integrations with APM tools like AppDynamics and New Relic in addition to log tools like Splunk, Elastic, and Sumo Logic. This should <b>take you 30 seconds.</b></p>



<p>For each verification source, you need to specify the target application details and default time period so that Harness&#8217; unsupervised machine learning algorithms can immediately begin to process, analyze, and verify the data each of your verification sources provides.</p>



<p>Instead of humans manually looking at monitoring metrics or log data to verify each canary phase, Harness can automate this entire step completely by comparing the value of metrics and the contents of event data before and after each of your canary phases.</p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="445" src="https://blog.harness.io/wp-content/uploads/2022/01/AppDynamics-Verification.png" alt="Example: AppDynamics Verification" class="wp-image-267754" srcset="https://blog.harness.io/wp-content/uploads/2022/01/AppDynamics-Verification.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/AppDynamics-Verification-300x191.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<p>Repeat the above steps for canary phases 2 &amp; 3 and your canary workflow wizard should look like this:</p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="413" src="https://blog.harness.io/wp-content/uploads/2022/01/Canary-Deployment-Workflow-Wizard.png" alt="Canary Deployment Workflow Wizard" class="wp-image-267755" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Canary-Deployment-Workflow-Wizard.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Canary-Deployment-Workflow-Wizard-300x177.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<p>At this point, you have a few optional steps to consider:</p>



<ul><li><strong>Notification strategy</strong> &#8211; what events in your canary workflow do you want to notify people with?</li><li><strong>Failure strategy</strong> &#8211; what steps do you want to take if any of your canary phase verifications fail? The default is an automated rollback.</li><li><strong>Workflow variables</strong> &#8211; do you want to &#8220;templatize&#8221; this canary workflow so other teams or services can use the same deployment workflow?</li></ul>



<p>Once completed, your workflow should look something like this:</p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="352" src="https://blog.harness.io/wp-content/uploads/2022/01/Canary-Deployment.png" alt="It's Alive! Canary Deployment Workflow" class="wp-image-267756" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Canary-Deployment.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Canary-Deployment-300x151.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<h2>Step 7: Create a Pipeline for Canary Workflow</h2>



<p>A pipeline in Harness is made up of one or more stages than execute in serial or parallel, with each stage referencing a specific deployment workflow. Most Harness customers have a 4 to 5 stage CD pipeline that allows them to deploy their services/artifacts across each of their dev, QA, staging, and production <a href="https://harness.io/blog/deployment-environments/" target="_blank" rel="noreferrer noopener">environments</a>. For our canary deployment, let&#8217;s create a simple one-stage pipeline that invokes the Canary workflow we just created.</p>



<p>Go to: <strong>Setup > Your Application > Add Pipeline</strong></p>



<p>Click the blue <strong>+</strong> round button, add a new pipeline stage called <strong>Production</strong>, and select the canary workflow we have just created. <strong>This should take you 30 seconds.</strong></p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="305" src="https://blog.harness.io/wp-content/uploads/2022/01/Production-Stage.png" alt="Add Production Stage" class="wp-image-267757" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Production-Stage.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Production-Stage-300x131.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<h2>Step 8: Create a Trigger to Execute Our CD Pipeline</h2>



<p>The final step is to now create a trigger that will execute the pipeline that contains our canary workflow. This is important because you may only want to trigger a production canary workflow under certain conditions.</p>



<p>Go to: <strong>Setup > Your Application > Add Trigger</strong></p>



<p>Enter a name for your trigger, then pick the condition <strong>On New Artifact</strong> for your trigger, and finally, select the pipeline you have just created in Step 7. <strong>This should take you 1 minute.</strong></p>



<div class="wp-block-image"><figure class="aligncenter size-large"><img loading="lazy" width="700" height="397" src="https://blog.harness.io/wp-content/uploads/2022/01/Trigger.png" alt="Add Trigger" class="wp-image-267758" srcset="https://blog.harness.io/wp-content/uploads/2022/01/Trigger.png 700w, https://blog.harness.io/wp-content/uploads/2022/01/Trigger-300x170.png 300w" sizes="(min-width: 960px) 75vw, 100vw" /></figure></div>



<p></p>



<p>That&#8217;s it! You&#8217;re all done with building your canary deployment.</p>



<p>How does Harness compare to your existing canary deployment process? If you&#8217;re interested in evaluating Harness, you can <a href="https://harness.io/products/continuous-delivery/" target="_blank" rel="noreferrer noopener">try our CD module</a> today.</p>



<p>Cheers!</p>



<p>Steve</p>



<p>@BurtonSays</p>
