1111App\Models\Blog Object
(
    [table:protected] => blogs
    [fillable:protected] => Array
        (
            [0] => user_id
            [1] => date
            [2] => image
            [3] => title
            [4] => slug
            [5] => detail
            [6] => post_excerpt
            [7] => status
            [8] => tags
            [9] => related_blog_id
            [10] => category_id
            [11] => meta_detail
            [12] => meta_keyword
        )

    [casts:protected] => Array
        (
            [tags] => array
        )

    [connection:protected] => mysql
    [primaryKey:protected] => id
    [keyType:protected] => int
    [incrementing] => 1
    [with:protected] => Array
        (
        )

    [withCount:protected] => Array
        (
        )

    [preventsLazyLoading] => 
    [perPage:protected] => 15
    [exists] => 1
    [wasRecentlyCreated] => 
    [escapeWhenCastingToString:protected] => 
    [attributes:protected] => Array
        (
            [id] => 65
            [user_id] => 4
            [category_id] => 1
            [title] => Use ArgoCD and GitOps to Deploy DevOps-based Application on Kubernetes
            [slug] => use-argocd-and-gitops-to-deploy-devops-based-application-on-kubernetes
            [image] => 1711088747ArgoCD and GitOps to Deploy DevOps-based Application on Kubernetes.webp
            [date] => 2022-03-23
            [detail] => <p>Deploying DevOps-based applications or any other application on Kubernetes can benefit in terms of infrastructural advantages, such as scaling, flexibility, distributed component management, and application versioning. In the DevOps development process, continuous integration and deployment (CI/CD) mechanisms often work at a high level of abstraction, offering functionalities like version controlling, logging amendments, and rollback. To deal with this abstraction layer, a popular approach called GitOps comes to the rescue. In this blog, we will use ArgoCD to synchronize and deploy a DevOps-based application stored in the GitHub repository on Kubernetes clusters.</p>
<h5><span style="color: #4cbaba;">Prerequisites:</span></h5>
<ul>
<li>An SSH key pair on your operating system (Linux, macOS, BSD) and for Windows OS, work with Windows subsystem for Linux.</li>
<li>A Kubernetes cluster with one worker node</li>
<li><span style="color: #4cbaba;"><code>kubectl</code></span> setup with connection to Kubernetes cluster</li>
</ul>
<h5><span style="color: #4cbaba;">Step 1: Install ArgoCD on Kubernetes Cluster</span></h5>
<ul>
<li>Use the following command to validate the Kubernetes configuration setup with kubectl to be able to ping worker nodes.</li>
</ul>
<pre><code>$ kubectl get nodes</code></pre>
<p>This command then will return the list of worker nodes with <span style="color: #4cbaba;">Ready</span> status to proceed.</p>
<ul>
<li>Create the <code>argocd</code> namespace in the Kubernetes cluster, having ArgoCD and associated services:</li>
</ul>
<pre><code>$ kubectl create namespace argocd</code></pre>
<ul>
<li>Then project maintainers will provide the Argo CD installation script as mentioned below, so run it.</li>
</ul>
<pre><code>$ kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml</code></pre>
<ul>
<li><span class="TextRun SCXW3242169 BCX0" lang="EN-GB" xml:lang="EN-GB" data-contrast="auto"><span class="NormalTextRun SCXW3242169 BCX0">Run the below-mentioned command to check the progress of the </span><span class="NormalTextRun SpellingErrorV2 SCXW3242169 BCX0">ArgoCD</span><span class="NormalTextRun SCXW3242169 BCX0"> installation process:</span></span><span class="EOP SCXW3242169 BCX0" data-ccp-props="{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}">&nbsp;</span></li>
</ul>
<pre><code>$ watch kubectl get pods -n argocd</code></pre>
<p>By default, it shows five pods that have gained the Running state.</p>
<ul>
<li>Press <code>Ctrl+C</code> to exit the installation <span style="color: #4cbaba;">Watch</span> interface.</li>
</ul>
<p>Now, you&rsquo;re all set with ArgoCD in the Kubernetes cluster!</p>
<h5><span style="color: #4cbaba;">Step 2: Forward Ports to Access ArgoCD</span></h5>
<p>As Kubernetes deploys services by default to arbitrary networks in the cluster, there is a requirement to forward associated ports to grant them access to be able to use them from the respective OS. ArgoCD configures a service called <code>argocd-server</code> on port number 443 internally, but as this port is the default HTTPS one, it is recommended to change it to another port, like 8080.</p>
<ul>
<li>Use the following command to forward ports:</li>
</ul>
<pre><code>$ kubectl port-forward svc/argocd-server -n argocd 8080:443</code></pre>
<ul>
<li>To quit the blocking process of the port forwarding, you can press the <code>Ctrl+C</code> combination, as post forwarding will block the terminal till its active time.</li>
<li>Navigate to the <code>localhost:8080</code> to access the ArgoCD from the web browser, in which you&rsquo;ll have to take the help of the command line to get to the next step.</li>
</ul>
<p><em><span style="color: #4cbaba;">Note:</span> During step 3, you may need to surpass the security warning as ArgoCD has yet to be configured with an SSL certificate.</em></p>
<h5><span style="color: #4cbaba;">Step 3: Use Command Line to Work on ArgoCD</span></h5>
<ul>
<li>Ensure the installation of Command <code>argocd</code> on the local machine to deal with ArgoCD instance settings.</li>
<li>If <code>argocd</code> is not installed, it is recommended to install it using <span style="color: #4cbaba;">Homebrew package manager</span>, a popular command-line tool available for macOS and Linux machines.</li>
<li>Use the following command to install the Homebrew tool on your local machine:</li>
</ul>
<pre><code>$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</code></pre>
<ul>
<li>Enter the password and use the brew command to install ArgoCD from the terminal:</li>
</ul>
<pre><code>$ brew install argocd</code></pre>
<ul>
<li>The brew command then returns the argocd command, but before using it, use kubectl to get the auto-generated admin login credentials.</li>
<li>Use the login credentials to pass a path to a JSON file, using Kubernetes secrets, to extract the associated value:</li>
</ul>
<pre><code>$ kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d; echo</code></pre>
<ul>
<li>Navigate to the localhost: 8080 in your browser, log into your ArgoCD dashboard as admin:</li>
</ul>
<p><img class="aligncenter wp-image-3091 size-full" src="../../../wp-content/uploads/2022/03/image-1.png" alt="ArgoCD dashboard" width="724" height="139" /></p>
<ul>
<li>Check everything on the localhost operated ArgoCD dashboard, whether they seem to on their place. Then use the argocs login command to log into your ArgoCD account from the command-line interface.</li>
</ul>
<pre><code>$ argocd login localhost:8080</code></pre>
<ul>
<li>During the login process, you&rsquo;ll surely get many certificate-related security warnings like before, thus, whenever they pop up, press the <code>Y</code> key.</li>
<li>You can also change the existing ArgoCD account password. For that, use command:</li>
</ul>
<pre><code>$ argocd account update-password</code></pre>
<p>Now, you&rsquo;re all set for using ArgoCD to deploy applications.</p>
<h5><span style="color: #4cbaba;">Step 4: Manage Multiple Kubernetes Clusters</span></h5>
<ul>
<li>Use the following command to list all Kubernetes clusters to decide a particular one for deploying your DevOps-based application:</li>
</ul>
<pre><code>$ kubectl config get-contexts -o name</code></pre>
<ul>
<li>Register test-target-cluster with ArgoCD to deploy the application into it:</li>
</ul>
<pre><code>$ argocd cluster add target-k8s</code></pre>
<p>Now, additional cluster login credentials are added to ArgoCD, enabling it for deploying services.</p>
<h5><span style="color: #4cbaba;">Step 5: Deploy Your Application on Kubernetes Cluster</span></h5>
<p>Here, you&rsquo;ll know the procedures to deploy the application to various Kubernetes clusters. The ArgoCD oversees the management of applications&rsquo; source codes, written by considering GitOps fundamentals and stored in GitHub repo. Here, we&rsquo;re going to deploy a helm-guestbook demo with the Helm chart. You can also consider it as one of the robust Kubernetes management solutions.</p>
<ul>
<li>Provide a specific path to the Git repository, storing helm-guestbook demo. For that, you&rsquo;ll have to pass location and namespace:</li>
</ul>
<pre><code>$ argocd app create helm-guestbook --repo https://github.com/argoproj/argocd-example-apps.git --path helm-guestbook --dest-server https://kubernetes.default.svc --dest-namespace default</code></pre>
<ul>
<li>Now check the status of the application created into the ArgoCD:</li>
</ul>
<pre><code>$ argocd app get helm-guestbook</code></pre>
<p>If it returns <code>Sync Status</code> as <code>OutOfSync</code>, consider application status as normal. It also indicates the successful retrieval of the application helm chart from the GitHub repo.</p>
<ul>
<li>Now, use Kubernetes resources to deploy the application:</li>
</ul>
<pre><code>$ argocd app sync helm-guestbook</code></pre>
<p>Here, <code>sync</code> references the deployment of the application under agreement with GitOps principle, aiming to track the application using ArgoCD in the 1:1 collaboration with its upstream configuration. Now, your application is successfully deployed on the Kubernetes cluster using ArgoCD. You can also use the web interface of the ArgoCD application, but the command line makes the process faster and reproducible.</p>
<ul>
<li>Once deployment is done, you can check the process via referring to the ArgoCD web dashboard opened using <code>localhost: 8080</code>.</li>
</ul>
<p><img class="aligncenter size-full wp-image-3092" src="../../../wp-content/uploads/2022/03/image-2.png" alt="ArgoCD web dashboard view showing application deployment data" width="732" height="575" /></p>
<ul>
<li>Run the application deployment on the browser. For this, you&rsquo;ll need to forward the helm guestbook app port to HTTP port 80 or 9090:</li>
</ul>
<pre><code>$ kubectl port-forward svc/helm-guestbook 9090:80</code></pre>
<ul>
<li>Use the <code>Ctrl+C</code> shortcut key to stop the terminal blocking pop-ups, and then forward the port to <code>localhost: 9090</code> to see the web view of the guestbook application demo:</li>
</ul>
<p><img class="aligncenter size-full wp-image-3093" src="../../../wp-content/uploads/2022/03/image-3.png" alt="Application Deployment on Kubernetes using ArgoCD and GitOps (GitHub Repo+DevOps rules) " width="727" height="393" />At last, it&rsquo;ll reflect all new pushes onto the GitHub repo in the ArgoCD, which will continuously resync the application deployment alongside ensuring its high availability.</p>
<h5><span style="color: #4cbaba;">Conclusion:</span></h5>
<p>As Kubernetes contains many abstraction layers, it is necessary to ensure the maintainability of deployments. And in that case, GitOps principles provide feasible solutions. Have queries related to our <span style="color: #4cbaba;"><a style="color: #4cbaba;" href="../../../services/managed-it">DevOps solutions and services</a></span>? Book your first free 60 mins of <span style="color: #4cbaba;"><a style="color: #4cbaba;" href="https://outlook.office365.com/owa/calendar/CloudStakesTechnologyPvtLtd@cloudstakes.com/bookings/">DevOps consultation</a></span> with us TODAY!</p>
            [post_excerpt] => Read this blog to know the steps to synchronize and deploy a DevOps-based application stored in the GitHub repository on Kubernetes clusters using ArgoCD.
            [tags] => 
            [related_blog_id] => 65
            [status] => 1
            [featured] => 0
            [meta_detail] => Read this blog to know the steps to synchronize and deploy a DevOps-based application stored in the GitHub repository on Kubernetes clusters using ArgoCD.
            [meta_keyword] => 
            [created_at] => 2023-01-10 03:44:50
            [updated_at] => 2024-03-22 11:55:47
        )

    [original:protected] => Array
        (
            [id] => 65
            [user_id] => 4
            [category_id] => 1
            [title] => Use ArgoCD and GitOps to Deploy DevOps-based Application on Kubernetes
            [slug] => use-argocd-and-gitops-to-deploy-devops-based-application-on-kubernetes
            [image] => 1711088747ArgoCD and GitOps to Deploy DevOps-based Application on Kubernetes.webp
            [date] => 2022-03-23
            [detail] => <p>Deploying DevOps-based applications or any other application on Kubernetes can benefit in terms of infrastructural advantages, such as scaling, flexibility, distributed component management, and application versioning. In the DevOps development process, continuous integration and deployment (CI/CD) mechanisms often work at a high level of abstraction, offering functionalities like version controlling, logging amendments, and rollback. To deal with this abstraction layer, a popular approach called GitOps comes to the rescue. In this blog, we will use ArgoCD to synchronize and deploy a DevOps-based application stored in the GitHub repository on Kubernetes clusters.</p>
<h5><span style="color: #4cbaba;">Prerequisites:</span></h5>
<ul>
<li>An SSH key pair on your operating system (Linux, macOS, BSD) and for Windows OS, work with Windows subsystem for Linux.</li>
<li>A Kubernetes cluster with one worker node</li>
<li><span style="color: #4cbaba;"><code>kubectl</code></span> setup with connection to Kubernetes cluster</li>
</ul>
<h5><span style="color: #4cbaba;">Step 1: Install ArgoCD on Kubernetes Cluster</span></h5>
<ul>
<li>Use the following command to validate the Kubernetes configuration setup with kubectl to be able to ping worker nodes.</li>
</ul>
<pre><code>$ kubectl get nodes</code></pre>
<p>This command then will return the list of worker nodes with <span style="color: #4cbaba;">Ready</span> status to proceed.</p>
<ul>
<li>Create the <code>argocd</code> namespace in the Kubernetes cluster, having ArgoCD and associated services:</li>
</ul>
<pre><code>$ kubectl create namespace argocd</code></pre>
<ul>
<li>Then project maintainers will provide the Argo CD installation script as mentioned below, so run it.</li>
</ul>
<pre><code>$ kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml</code></pre>
<ul>
<li><span class="TextRun SCXW3242169 BCX0" lang="EN-GB" xml:lang="EN-GB" data-contrast="auto"><span class="NormalTextRun SCXW3242169 BCX0">Run the below-mentioned command to check the progress of the </span><span class="NormalTextRun SpellingErrorV2 SCXW3242169 BCX0">ArgoCD</span><span class="NormalTextRun SCXW3242169 BCX0"> installation process:</span></span><span class="EOP SCXW3242169 BCX0" data-ccp-props="{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:259}">&nbsp;</span></li>
</ul>
<pre><code>$ watch kubectl get pods -n argocd</code></pre>
<p>By default, it shows five pods that have gained the Running state.</p>
<ul>
<li>Press <code>Ctrl+C</code> to exit the installation <span style="color: #4cbaba;">Watch</span> interface.</li>
</ul>
<p>Now, you&rsquo;re all set with ArgoCD in the Kubernetes cluster!</p>
<h5><span style="color: #4cbaba;">Step 2: Forward Ports to Access ArgoCD</span></h5>
<p>As Kubernetes deploys services by default to arbitrary networks in the cluster, there is a requirement to forward associated ports to grant them access to be able to use them from the respective OS. ArgoCD configures a service called <code>argocd-server</code> on port number 443 internally, but as this port is the default HTTPS one, it is recommended to change it to another port, like 8080.</p>
<ul>
<li>Use the following command to forward ports:</li>
</ul>
<pre><code>$ kubectl port-forward svc/argocd-server -n argocd 8080:443</code></pre>
<ul>
<li>To quit the blocking process of the port forwarding, you can press the <code>Ctrl+C</code> combination, as post forwarding will block the terminal till its active time.</li>
<li>Navigate to the <code>localhost:8080</code> to access the ArgoCD from the web browser, in which you&rsquo;ll have to take the help of the command line to get to the next step.</li>
</ul>
<p><em><span style="color: #4cbaba;">Note:</span> During step 3, you may need to surpass the security warning as ArgoCD has yet to be configured with an SSL certificate.</em></p>
<h5><span style="color: #4cbaba;">Step 3: Use Command Line to Work on ArgoCD</span></h5>
<ul>
<li>Ensure the installation of Command <code>argocd</code> on the local machine to deal with ArgoCD instance settings.</li>
<li>If <code>argocd</code> is not installed, it is recommended to install it using <span style="color: #4cbaba;">Homebrew package manager</span>, a popular command-line tool available for macOS and Linux machines.</li>
<li>Use the following command to install the Homebrew tool on your local machine:</li>
</ul>
<pre><code>$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</code></pre>
<ul>
<li>Enter the password and use the brew command to install ArgoCD from the terminal:</li>
</ul>
<pre><code>$ brew install argocd</code></pre>
<ul>
<li>The brew command then returns the argocd command, but before using it, use kubectl to get the auto-generated admin login credentials.</li>
<li>Use the login credentials to pass a path to a JSON file, using Kubernetes secrets, to extract the associated value:</li>
</ul>
<pre><code>$ kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d; echo</code></pre>
<ul>
<li>Navigate to the localhost: 8080 in your browser, log into your ArgoCD dashboard as admin:</li>
</ul>
<p><img class="aligncenter wp-image-3091 size-full" src="../../../wp-content/uploads/2022/03/image-1.png" alt="ArgoCD dashboard" width="724" height="139" /></p>
<ul>
<li>Check everything on the localhost operated ArgoCD dashboard, whether they seem to on their place. Then use the argocs login command to log into your ArgoCD account from the command-line interface.</li>
</ul>
<pre><code>$ argocd login localhost:8080</code></pre>
<ul>
<li>During the login process, you&rsquo;ll surely get many certificate-related security warnings like before, thus, whenever they pop up, press the <code>Y</code> key.</li>
<li>You can also change the existing ArgoCD account password. For that, use command:</li>
</ul>
<pre><code>$ argocd account update-password</code></pre>
<p>Now, you&rsquo;re all set for using ArgoCD to deploy applications.</p>
<h5><span style="color: #4cbaba;">Step 4: Manage Multiple Kubernetes Clusters</span></h5>
<ul>
<li>Use the following command to list all Kubernetes clusters to decide a particular one for deploying your DevOps-based application:</li>
</ul>
<pre><code>$ kubectl config get-contexts -o name</code></pre>
<ul>
<li>Register test-target-cluster with ArgoCD to deploy the application into it:</li>
</ul>
<pre><code>$ argocd cluster add target-k8s</code></pre>
<p>Now, additional cluster login credentials are added to ArgoCD, enabling it for deploying services.</p>
<h5><span style="color: #4cbaba;">Step 5: Deploy Your Application on Kubernetes Cluster</span></h5>
<p>Here, you&rsquo;ll know the procedures to deploy the application to various Kubernetes clusters. The ArgoCD oversees the management of applications&rsquo; source codes, written by considering GitOps fundamentals and stored in GitHub repo. Here, we&rsquo;re going to deploy a helm-guestbook demo with the Helm chart. You can also consider it as one of the robust Kubernetes management solutions.</p>
<ul>
<li>Provide a specific path to the Git repository, storing helm-guestbook demo. For that, you&rsquo;ll have to pass location and namespace:</li>
</ul>
<pre><code>$ argocd app create helm-guestbook --repo https://github.com/argoproj/argocd-example-apps.git --path helm-guestbook --dest-server https://kubernetes.default.svc --dest-namespace default</code></pre>
<ul>
<li>Now check the status of the application created into the ArgoCD:</li>
</ul>
<pre><code>$ argocd app get helm-guestbook</code></pre>
<p>If it returns <code>Sync Status</code> as <code>OutOfSync</code>, consider application status as normal. It also indicates the successful retrieval of the application helm chart from the GitHub repo.</p>
<ul>
<li>Now, use Kubernetes resources to deploy the application:</li>
</ul>
<pre><code>$ argocd app sync helm-guestbook</code></pre>
<p>Here, <code>sync</code> references the deployment of the application under agreement with GitOps principle, aiming to track the application using ArgoCD in the 1:1 collaboration with its upstream configuration. Now, your application is successfully deployed on the Kubernetes cluster using ArgoCD. You can also use the web interface of the ArgoCD application, but the command line makes the process faster and reproducible.</p>
<ul>
<li>Once deployment is done, you can check the process via referring to the ArgoCD web dashboard opened using <code>localhost: 8080</code>.</li>
</ul>
<p><img class="aligncenter size-full wp-image-3092" src="../../../wp-content/uploads/2022/03/image-2.png" alt="ArgoCD web dashboard view showing application deployment data" width="732" height="575" /></p>
<ul>
<li>Run the application deployment on the browser. For this, you&rsquo;ll need to forward the helm guestbook app port to HTTP port 80 or 9090:</li>
</ul>
<pre><code>$ kubectl port-forward svc/helm-guestbook 9090:80</code></pre>
<ul>
<li>Use the <code>Ctrl+C</code> shortcut key to stop the terminal blocking pop-ups, and then forward the port to <code>localhost: 9090</code> to see the web view of the guestbook application demo:</li>
</ul>
<p><img class="aligncenter size-full wp-image-3093" src="../../../wp-content/uploads/2022/03/image-3.png" alt="Application Deployment on Kubernetes using ArgoCD and GitOps (GitHub Repo+DevOps rules) " width="727" height="393" />At last, it&rsquo;ll reflect all new pushes onto the GitHub repo in the ArgoCD, which will continuously resync the application deployment alongside ensuring its high availability.</p>
<h5><span style="color: #4cbaba;">Conclusion:</span></h5>
<p>As Kubernetes contains many abstraction layers, it is necessary to ensure the maintainability of deployments. And in that case, GitOps principles provide feasible solutions. Have queries related to our <span style="color: #4cbaba;"><a style="color: #4cbaba;" href="../../../services/managed-it">DevOps solutions and services</a></span>? Book your first free 60 mins of <span style="color: #4cbaba;"><a style="color: #4cbaba;" href="https://outlook.office365.com/owa/calendar/CloudStakesTechnologyPvtLtd@cloudstakes.com/bookings/">DevOps consultation</a></span> with us TODAY!</p>
            [post_excerpt] => Read this blog to know the steps to synchronize and deploy a DevOps-based application stored in the GitHub repository on Kubernetes clusters using ArgoCD.
            [tags] => 
            [related_blog_id] => 65
            [status] => 1
            [featured] => 0
            [meta_detail] => Read this blog to know the steps to synchronize and deploy a DevOps-based application stored in the GitHub repository on Kubernetes clusters using ArgoCD.
            [meta_keyword] => 
            [created_at] => 2023-01-10 03:44:50
            [updated_at] => 2024-03-22 11:55:47
        )

    [changes:protected] => Array
        (
        )

    [classCastCache:protected] => Array
        (
        )

    [attributeCastCache:protected] => Array
        (
        )

    [dates:protected] => Array
        (
        )

    [dateFormat:protected] => 
    [appends:protected] => Array
        (
        )

    [dispatchesEvents:protected] => Array
        (
        )

    [observables:protected] => Array
        (
        )

    [relations:protected] => Array
        (
        )

    [touches:protected] => Array
        (
        )

    [timestamps] => 1
    [hidden:protected] => Array
        (
        )

    [visible:protected] => Array
        (
        )

    [guarded:protected] => Array
        (
            [0] => *
        )

)