{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This walkthrough will cover every step needed to get your docker image built and deployed through FlexDeploy. In this example we will be deploying the image to a Kubernetes Cluster on Oracle Cloud Infrastructure via Helm. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If you don’t have your own docker application you can follow along using the ","type":"text"},{"text":"Natours","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/joel-wenzel/natours"}}]},{"text":" repository used in this example.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Contents","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"_parentId":{"value":"9803747732"},"exclude":{"value":"Contents"}},"macroMetadata":{"macroId":{"value":"f00de83b-50ec-4421-b1ef-bcf02ae0d7ed"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docker CLI","type":"text","marks":[{"type":"strong"}]},{"text":" - An available docker cli for building the image","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Kubernetes Cluster","type":"text","marks":[{"type":"strong"}]},{"text":" - For deployment","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This guide will be using ","type":"text"},{"text":"OKE","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengcreatingclusterusingoke.htm#:~:text=the%20navigation%20menu.-,Under%20Solutions%20and%20Platform%2C%20go%20to%20Developer%20Services%20and%20click,Create%20and%20click%20Launch%20Workflow."}}]},{"text":", but any cluster will suffice.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Kubectl/Helm","type":"text","marks":[{"type":"strong"}]},{"text":" - ","type":"text"},{"text":"Install ","type":"text","marks":[{"type":"underline"}]},{"text":"kubectl ","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://kubernetes.io/docs/tasks/tools/install-kubectl/"}}]},{"text":"and ","type":"text","marks":[{"type":"underline"}]},{"text":"helm ","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://helm.sh/docs/intro/install/"}}]},{"text":"on the FlexDeploy server","type":"text","marks":[{"type":"underline"}]},{"text":".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Be sure the appropriate context is configured for your K8s Cluster.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FlexDeploy Knowledge","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We won’t be covering some of the more basic steps like creating SCM Instances and other Topology configuration.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Building and Pushing the Image","type":"text"}]},{"type":"paragraph","content":[{"text":"The first goal is to build our image. In the case of the ","type":"text"},{"text":"Natours","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/joel-wenzel/natours"}}]},{"text":" repository, we don’t need any additional compile steps. All we need to do is run docker build with the appropriate commands","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating the Build Workflow","type":"text"}]},{"type":"paragraph","content":[{"text":"The build ","type":"text"},{"text":"workflow ","type":"text","marks":[{"type":"strong"}]},{"text":"is only going to need two steps: ","type":"text"},{"text":"clone the source code","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"build the image","type":"text","marks":[{"type":"strong"}]},{"text":". The buildProjectImage step is going to use the configuration directly in the project. As such, the default configuration is is fine for both steps, simply drag and drop.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1535,"id":"d6d08637-fbad-4f0c-966d-d76a2220d3a2","collection":"contentId-9803747732","type":"file","height":719}}]},{"type":"expand","attrs":{"title":"Workflow Source"},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n BuildProjectImage\n \n \n \n cloneProjectSources\n 1\n \n FlexagonGITPlugin\n cloneProjectSources\n false\n false\n \n All\n \n \n \n \n \n \n \n \n buildProjectImage\n 2\n \n FlexagonDockerPlugin\n buildProjectImage\n false\n false\n \n All\n \n Any\n \n \n FDDKR_INP_DOCKER_FILE\n Text\n false\n String\n \n \n FDDKR_INP_IMAGE_NAME\n Text\n false\n String\n \n \n FDDKR_INP_PUSH_IMAGE\n Text\n false\n Boolean\n false\n \n \n \n \n \n FDDKR_OUT_IMAGE_ID\n \n \n \n \n \n \n\n","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating a Registry Account","type":"text"}]},{"type":"paragraph","content":[{"text":"If we are going to be pushing our image anywhere, we will need a Registry Account in FlexDeploy. ","type":"text"},{"text":"Navigate to Topology->Integrations->Containers ","type":"text","marks":[{"type":"strong"}]},{"text":"and ","type":"text"},{"text":"click the Plus","type":"text","marks":[{"type":"strong"}]},{"text":" button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1535,"id":"496dda72-1930-4cf1-bc98-2cc46cc5405c","collection":"contentId-9803747732","type":"file","height":719}}]},{"type":"paragraph","content":[{"text":"Be sure to select the Provider as ","type":"text"},{"text":"DockerRegistry ","type":"text","marks":[{"type":"strong"}]},{"text":"and populate the information as necessary. In the above account it is configured to push to the joelwenzel account on ","type":"text"},{"text":"dockerhub.com","type":"text","marks":[{"type":"link","attrs":{"href":"https://hub.docker.com/"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating Additional Build Topology","type":"text"}]},{"type":"paragraph","content":[{"text":"While still on the Topology screen, we can create the remaining items for the build process.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Done Offscreen","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an endpoint where Docker is installed","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If docker is installed on the FlexDeploy server, the localhost endpoint can be used.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a Docker instance","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the Build Environment to the Instance","type":"text"}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Ensure that the ","type":"text"},{"text":"Docker Instance has the workflow created above","type":"text","marks":[{"type":"strong"}]},{"text":" added. ","type":"text"},{"text":"This is how FlexDeploy knows what properties to show on certain screens.","type":"text","marks":[{"type":"em"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1535,"id":"5c2a87e2-4032-473a-85d2-def5ad34004f","collection":"contentId-9803747732","type":"file","height":721}}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Docker on Windows or Docker-Desktop","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If you are using docker on windows, you will need to perform these ","type":"text"},{"text":"additional steps","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD57/pages/2639101957/Docker+on+Windows"}}]},{"text":".","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Done Offscreen","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the Docker Endpoint to your Docker-Build EnvInst in Topology Overview","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the SCM Instance for the Git repository","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Setting up the Project","type":"text"}]},{"type":"paragraph","content":[{"text":"Lastly, create a new Project in FlexDeploy. Give it a name that closely resembles your Git repository name and select ","type":"text"},{"text":"Container ","type":"text","marks":[{"type":"strong"}]},{"text":"as the Classification.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1536,"id":"93e3c7d9-de70-49ed-ae02-a14f6d3ab048","collection":"contentId-9803747732","type":"file","height":722}}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Done Offscreen","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update the Project Configuration tab to include the Build Workflow, Build Instance and SCM Configuration.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"After creating the Project, click on the ","type":"text"},{"text":"Container Configuration","type":"text","marks":[{"type":"strong"}]},{"text":" tab. It is here where we specify the image tag information and build behavior. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the following configuration:","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1536,"id":"a5ce07a1-42e4-4c54-b57b-82002ac75d46","collection":"contentId-9803747732","type":"file","height":722}}]},{"type":"paragraph","content":[{"text":"Naturally your image name and account could be different compared to what’s shown above. ","type":"text"},{"text":"With this configuration","type":"text","marks":[{"type":"strong"}]},{"text":", FlexDeploy will ","type":"text"},{"text":"build an image","type":"text","marks":[{"type":"strong"}]},{"text":" with an incrementing Project Version","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"every time we run a build. In addition to ","type":"text"},{"text":"tagging the image with the ProjectVersion","type":"text","marks":[{"type":"strong"}]},{"text":" it will ","type":"text"},{"text":"tag with latest and push","type":"text","marks":[{"type":"strong"}]},{"text":" the image to the ","type":"text"},{"text":"Docker Hub","type":"text","marks":[{"type":"strong"}]},{"text":" registry that was set up earlier.","type":"text"}]},{"type":"paragraph","content":[{"text":"We will come back to image scanning, but for now lets finally build the image. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Run a build","type":"text"}]},{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Build ","type":"text","marks":[{"type":"strong"}]},{"text":"button on the Project Activity screen and if everything goes well we should have a new version of the natours image.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1536,"id":"04a68643-9efd-49ad-9615-a6ee4757f108","collection":"contentId-9803747732","type":"file","height":722}}]},{"type":"paragraph","content":[{"text":"Notice that both version ","type":"text"},{"text":"1.0.1","type":"text","marks":[{"type":"strong"}]},{"text":" and the ","type":"text"},{"text":"latest ","type":"text","marks":[{"type":"strong"}]},{"text":"tag were both ","type":"text"},{"text":"pushed ","type":"text","marks":[{"type":"strong"}]},{"text":"to the registry.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1390,"id":"db10fe92-3dc9-4739-bf5f-6fe141a03c42","collection":"contentId-9803747732","type":"file","height":608}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Deploying the Containerized App","type":"text"}]},{"type":"paragraph","content":[{"text":"A reminder that before deployment, you should have kubectl and helm installed on the local FlexDeploy server and have a valid context configured. Similar to the build process, we will first configure the project.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating the Deploy Workflow","type":"text"}]},{"type":"paragraph","content":[{"text":"The only step our deploy workflow needs to do is run Helm, which we will do through the ","type":"text"},{"text":"deploy","type":"text","marks":[{"type":"strong"}]},{"text":" operation on the FlexDeployHelmPlugin. The only input specified is the ","type":"text"},{"text":"K8s Context ","type":"text","marks":[{"type":"strong"}]},{"text":"which should be the kubectl context as it shows when running","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"kubectl config current-context","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1536,"id":"2de7ede1-5ba9-4dc2-bea5-baca269a3ee9","collection":"contentId-9803747732","type":"file","height":722}}]},{"type":"expand","attrs":{"title":"Workflow Source"},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n DeployHelm\n \n \n \n deploy\n 1\n \n FlexagonHelmPlugin\n deploy\n true\n false\n \n All\n \n Any\n \n \n FDHLM_INP_CHART_NAME\n Text\n false\n String\n \n \n FDHLM_INP_K8S_CONTEXT\n Text\n false\n String\n oci-demo-cluster\n \n \n FDHLM_INP_RELEASE_NAME\n Text\n false\n String\n \n \n FDHLM_INP_VALUES_FILE\n Text\n false\n String\n \n \n FDHLM_INP_REPO_NAME\n Text\n false\n String\n \n \n FDHLM_INP_CONFIG_FILE\n Text\n false\n String\n \n \n FDHLM_BUILD_DEPENDENCIES\n Text\n false\n Boolean\n false\n \n \n FDHLM_INP_OPTIONS\n Text\n false\n String\n \n \n \n \n \n \n \n \n\n","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating the Deploy Topology","type":"text"}]},{"type":"paragraph","content":[{"text":"More of the same as what we did on the Build side of things. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Done Offscreen","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a Helm Instance","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Associate the DeployHelm workflow","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the Localhost endpoint on the Development Environment for the Helm Instance.","type":"text"}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1536,"id":"ea9f6801-332e-4520-8406-d153e7fda24b","collection":"contentId-9803747732","type":"file","height":722}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Finalizing the Project","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Done Offscreen","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Associate the Deploy Workflow and Deploy Instance on the Project Configuration tab.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Almost there, the final piece of the puzzle is to update the Helm configuration on the project.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Release Name","type":"text","marks":[{"type":"strong"}]},{"text":" - \"natours-\"+FD_ENVIRONMENT_CODE.toLowerCase()","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Chart Path","type":"text","marks":[{"type":"strong"}]},{"text":" - ","type":"text"},{"text":"https://github.com/joel-wenzel/charts/raw/develop/generic-0.1.0.tgz","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/joel-wenzel/charts/raw/develop/generic-0.1.0.tgz"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This chart will create a single pod deployment with a load balancer service.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Helm Parameters","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"These will likely change depending on your chart and docker image. ","type":"text"}]}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1536,"id":"666f06fd-a12a-4981-8a95-68ff6d39de12","collection":"contentId-9803747732","type":"file","height":722}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Deploying the Helm Release","type":"text"}]},{"type":"paragraph","content":[{"text":"Head back to the Project Activity Screen and click the deploy button. If everything goes well there will be a new successful deployment of the Helm Release.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1536,"id":"4f3ecadd-3021-467a-8600-ec84108043c2","collection":"contentId-9803747732","type":"file","height":722}}]},{"type":"paragraph","content":[{"text":"You may notice a few things that stand out compared to other FlexDeploy Projects, namely the Deployment link and Status. Both of these are shown for Container Projects only and offer some insight into the actual application that was deployed and some basic monitoring. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The deployment status is only monitored if Kubectl is installed on the local FlexDeploy server.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Bonus: Image Scanning","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have made it this far you have seen the bread and butter of Kubernetes deployments in FlexDeploy. If you want to take things to the next level this section will incorporate Image scanning via Anchore in our build process.","type":"text"}]},{"type":"paragraph","content":[{"text":"FlexDeploy supports native Anchore inline image scanning. What this means for you is that no additional installations or setup is needed apart from updating the Project configuration.","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"At this time, inline(local) image scanning is not supported on windows","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Updating the Project Image Scanning Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Navigate back to the ","type":"text"},{"text":"Container Configuration","type":"text","marks":[{"type":"strong"}]},{"text":" tab on the Project. Under the ","type":"text"},{"text":"Image Scanning ","type":"text","marks":[{"type":"strong"}]},{"text":"section, change the Scan Image drop down to ","type":"text"},{"text":"Before Push","type":"text","marks":[{"type":"strong"}]},{"text":" and set the ","type":"text"},{"text":"Fail When ","type":"text","marks":[{"type":"strong"}]},{"text":"script to ","type":"text"}]},{"type":"paragraph","content":[{"text":"STATUS == “fail”. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1536,"id":"15bb8659-b389-41d7-88cf-4b021d20cc24","collection":"contentId-9803747732","type":"file","height":722}}]},{"type":"paragraph","content":[{"text":"We have just told FlexDeploy to run an Anchore scan prior to pushing our image and if the scan Status is “fail” then the build will fail. ","type":"text"},{"text":"Save the changes","type":"text","marks":[{"type":"strong"}]},{"text":" and run another build. If you are using the natours repository, the build will now fail due to the scan results.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1536,"id":"069a3833-daf8-483c-b1d8-f34f692cfa3d","collection":"contentId-9803747732","type":"file","height":722}}]},{"type":"paragraph"}],"version":1}