{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"48afd532-fa0c-440a-a4ef-e2f17e7d52a8"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"672d1814-cb18-4b62-bb4a-b15c84f83307"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Objective","type":"text"}]},{"type":"paragraph","content":[{"text":"We have previously specified how Azure Synapse Artifacts deployment can be achieved using FlexDeploy in this article. In the current article we are going to elaborate more on how to implement package-based deployment for the same.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Design","type":"text"}]},{"type":"paragraph","content":[{"text":"There are two approaches we follow here:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Approach A: (Recommended)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"First Phase - Configuring a Generic Package based project. Select the JSON objects (say Linked Services, Pipeline etc.), generate the ARM template based on the selected resources and store it in a repository. This repository may contain all the ARM templates corresponding to different packages. Will showcase it later in this tutorial.","type":"text"}]},{"type":"paragraph","content":[{"text":"Second Phase - Configuring another package-based project that will fetching the ARM template from the repository as specified in previous phase and initiate the Synapse Release pipeline to deploy them to target workspaces.","type":"text"}]},{"type":"paragraph","content":[{"text":"The benefit of the second approach is there would be more control over the ARM template which can be edited as needed by adding a new parameter or variables etc.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Approach B:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Configuring a Generic Package based project. Select the JSON objects (say Linked Services, Pipeline etc.), generate the ARM template based on the selected resources and deploy the ARM template to target workspaces. In this case the customization on parameters needs to be directly done on the JSON files by the user.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Flow (Approach A)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Workflow configuration for generating ARM template and upload to Repository","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Build Workflow:","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note: For uploading the ARM template to repository, we have created another DevOps repository as ","type":"text"},{"text":"az-synapse-arm","type":"text","marks":[{"type":"em"}]},{"text":" and configured it in FlexDeploy-Integration with the code ","type":"text"},{"text":"SYNAPSEARM","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have some other repository present in GITHUB or Azure DevOps anywhere and want to use that, then please create accordingly and use the correct Instance Code in the workflow pasted below.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1744,"alt":"image-20240329-080026.png","id":"9302a26d-c7df-43d1-99e2-9789ae650872","collection":"contentId-10630955144","type":"file","height":1339}}]},{"type":"expand","attrs":{"title":"GenerateARMAndSyncToGIT"},"content":[{"type":"codeBlock","content":[{"text":"\n\n GenerateARMAndSyncToGIT\n \n \n \n execute\n 1\n \n FlexagonShellPlugin\n execute\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDSHELL_INP_CODE_SNIPPET\n Text\n false\n String\n # Source directory (parent directory A)\nSRC_DIR=$FD_TEMP_DIR\n\n# Target directory (parent directory B)\nDEST_DIR=$FD_TEMP_DIR/JSON\n\nmkdir -p $FD_TEMP_DIR/JSON\nchmod -R 777 $FD_TEMP_DIR/JSON\n\n# Copy .json files while preserving directory structure\nfind "$SRC_DIR" -type f -name "*.json" | while read -r file; do\n # Get the directory path relative to the source\n rel_path=$(dirname "${file#$SRC_DIR/}")\n \n # Create the same directory structure in the target\n mkdir -p "$DEST_DIR/$rel_path"\n \n # Copy the file to the target directory\n cp "$file" "$DEST_DIR/$rel_path"\ndone\n\necho "All JSON files have been copied successfully."\n \n \n FDSHELL_INP_STOP_ON_ERROR\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_DISABLE_ECHO\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_RESTRICT_ENVIRONMENT\n Text\n false\n String\n \n \n FDSHELL_INP_NO_SECURE_VARIABLES\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_LOCK\n Text\n false\n String\n \n \n \n \n \n \n \n \n publishArtifacts\n 2\n \n FlexagonAzurePlugin\n publishArtifacts\n false\n v2\n true\n false\n \n All\n \n Any\n \n \n FDAZ_DEVOPS_INP_FEED\n Expression\n false\n String\n \n FEED_NAME\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_NAME\n Expression\n false\n String\n \n (FD_PACKAGE_NAME + "-" + ARTIFACTS_PACKAGE_NAME).toLowerCase()\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_VERSION\n Expression\n false\n String\n \n PACKAGE_VERSION\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_DESCRIPTION\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_PROJECT_NAME\n Expression\n false\n String\n \n PROJECT_NAME\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_PATH\n Expression\n false\n String\n \n FD_TEMP_DIR + "/JSON"\n \n \n \n FDAZ_DEVOPS_INP_ADDITIONAL_PARAMS\n Text\n false\n String\n \n \n \n \n \n FDAZ_DEVOPS_OUT_ERR\n \n \n FDAZ_DEVOPS_OUT_RESP\n \n \n \n \n \n \n buildPipeline\n 3\n \n FlexagonAzurePlugin\n buildPipeline\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDAZ_DEVOPS_INP_BUILD_DEFINITION_ID\n Text\n false\n String\n \n \n \n FDAZ_DEVOPS_INP_DEFINITION_NAME\n Expression\n false\n String\n \n BUILD_DEFINITION_NAME\n \n \n \n FDAZ_DEVOPS_INP_QUEUE_ID\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_COMMIT_ID\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_BRANCH_NAME\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_PROJECT_NAME\n Expression\n false\n String\n \n PROJECT_NAME\n \n \n \n FDAZ_DEVOPS_INP_VARIABLES_LIST\n Expression\n false\n String\n \n "workspaceName:cicd-demo-test##artifactsPackageName:" + (FD_PACKAGE_NAME + "-" + ARTIFACTS_PACKAGE_NAME).toLowerCase() + "##feedName:" + PROJECT_NAME + "/" + FEED_NAME\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_NAME\n Expression\n false\n String\n \n (FD_PACKAGE_NAME + "-" + PACKAGE_NAME).toLowerCase()\n \n \n \n FDAZ_DEVOPS_INP_ADDITIONAL_PARAMS\n Text\n false\n String\n \n \n \n \n \n FDAZ_DEVOPS_OUT_ERR\n \n \n FDAZ_DEVOPS_OUT_RESP\n \n \n FDAZ_DEVOPS_OUT_BUILD_PIPELINE_WEB_URL\n \n \n \n \n \n \n downloadArtifacts\n 4\n \n FlexagonAzurePlugin\n downloadArtifacts\n false\n v2\n false\n true\n \n All\n \n Any\n \n \n FDAZ_DEVOPS_INP_FEED\n Expression\n false\n String\n \n FEED_NAME\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_NAME\n Expression\n false\n String\n \n (FD_PACKAGE_NAME + "-" + PACKAGE_NAME).toLowerCase()\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_VERSION\n Expression\n false\n String\n \n PACKAGE_VERSION\n \n \n \n FDAZ_DEVOPS_INP_PROJECT_NAME\n Expression\n false\n String\n \n PROJECT_NAME\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_PATH\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_ADDITIONAL_PARAMS\n Text\n false\n String\n \n \n \n \n \n FDAZ_DEVOPS_OUT_ERR\n \n \n FDAZ_DEVOPS_OUT_RESP\n \n \n \n \n \n \n clone\n 5\n \n FlexagonGITPlugin\n clone\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDGIT_INP_INSTANCE_CODE\n Text\n false\n String\n SYNAPSEARM\n \n \n FDGIT_INP_DEST_SUBFOLDER\n Text\n false\n String\n ARMTemplates\n \n \n FDGIT_INP_BRANCH\n Text\n false\n String\n importedartifacts\n \n \n FDGIT_INP_TREELESS_CLONE\n Text\n false\n Boolean\n false\n \n \n FDGIT_INP_DEPTH\n Text\n false\n Integer\n \n \n \n FDGIT_INP_SPARSE_CHECKOUT_FOLDERS\n Text\n false\n String\n \n \n \n \n \n \n \n \n copy\n 6\n \n FlexagonFilePlugin\n copy\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDFILE_INP_FILE_FILTER\n Text\n false\n String\n \n \n FDFILE_INP_FILE_FILTER_EXCLUDED\n Text\n false\n String\n \n \n FDFILE_INP_SOURCE_PATH\n Expression\n false\n String\n \n FD_ARTIFACTS_DIR\n \n \n \n FDFILE_INP_TARGET_PATH\n Expression\n false\n String\n \n FD_TEMP_DIR+"/ARMTemplates/"+FD_PACKAGE_NAME\n \n \n \n FDFILE_INP_CLEAN_DIRECTORY\n Text\n false\n Boolean\n true\n \n \n \n \n \n \n \n \n add\n 7\n \n FlexagonGITPlugin\n add\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDGIT_INP_INSTANCE_CODE\n Text\n false\n String\n SYNAPSEARM\n \n \n FDGIT_INP_DEST_SUBFOLDER\n Text\n false\n String\n ARMTemplates\n \n \n FDGIT_INP_FILELIST\n Text\n false\n String\n .\n \n \n \n \n \n \n \n \n commit\n 8\n \n FlexagonGITPlugin\n commit\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDGIT_INP_INSTANCE_CODE\n Text\n false\n String\n SYNAPSEARM\n \n \n FDGIT_INP_DEST_SUBFOLDER\n Text\n false\n String\n ARMTemplates\n \n \n FDGIT_INP_NAME\n Text\n false\n String\n \n \n FDGIT_INP_EMAIL\n Text\n false\n String\n \n \n FDGIT_INP_REVISION_MESSAGE\n Expression\n false\n String\n \n "ARM Template updated: "+ FD_PROJECT_VERSION\n \n \n \n \n \n \n \n \n \n push\n 9\n \n FlexagonGITPlugin\n push\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDGIT_INP_INSTANCE_CODE\n Text\n false\n String\n SYNAPSEARM\n \n \n FDGIT_INP_DEST_SUBFOLDER\n Text\n false\n String\n ARMTemplates\n \n \n FDGIT_INP_BRANCH\n Text\n false\n String\n importedartifacts\n \n \n FDGIT_INP_FOLLOW_TAGS\n Text\n false\n Boolean\n false\n \n \n \n \n \n \n \n \n\n","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1209,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1209,"alt":"image-20241022-075449.png","id":"e98d0fee-bec7-41be-89ad-5f70281f6bc6","collection":"contentId-10630955144","type":"file","height":580}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Project Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a Project by choosing the Classification: Package-based and Project Types as Generic","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":870,"alt":"image-20240329-064826.png","id":"57e026eb-20c0-4f6b-a7a4-9d1a44b106bb","collection":"contentId-10630955144","type":"file","height":309}}]},{"type":"paragraph","content":[{"text":"Once it is created the Source Control needs to be configured, so that we can discover the files from the respective repository.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1355,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1882,"alt":"image-20241021-161920.png","id":"d398fe0e-f013-4e9d-8d60-dd92a458f7b0","collection":"contentId-10630955144","type":"file","height":652}}]},{"type":"paragraph","content":[{"text":"For example, this is how the source control looks like:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1080,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1636,"alt":"image-20241021-162047.png","id":"2481f856-56b3-4ec0-ac35-92647d743b81","collection":"contentId-10630955144","type":"file","height":806}}]},{"type":"paragraph","content":[{"text":"Discover the files using File Catalog tab","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1279,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1673,"alt":"image-20241021-162149.png","id":"fdb17e6f-ef93-42ea-b2ef-323299679499","collection":"contentId-10630955144","type":"file","height":636}}]},{"type":"paragraph","content":[{"text":"Now we can create Package upon selecting specific JSON files.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1158,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1752,"alt":"image-20241021-162322.png","id":"c977587f-3070-407c-b713-902e8335ac12","collection":"contentId-10630955144","type":"file","height":435}}]},{"type":"paragraph","content":[{"text":"Click on the Configuration tab, select General and update the Build workflow with respective Target group.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1273,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1640,"alt":"image-20241021-162429.png","id":"2b58355a-5099-45e7-869b-c85f8de5660c","collection":"contentId-10630955144","type":"file","height":785}}]},{"type":"paragraph","content":[{"text":"We are not configuring any Deploy workflow in this Project for the purpose of this Tutorial, as all we need is to generate the ARM template and upload it to GIT.","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Project properties","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1317,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1749,"alt":"image-20241021-162955.png","id":"bb5a5193-add8-4286-9e9f-6c5fbfc29f6e","collection":"contentId-10630955144","type":"file","height":712}}]},{"type":"paragraph","content":[{"text":"Follow this ","type":"text"},{"text":"link","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10563911951/Azure+Synapse+Workspace+Artifacts+Deployment#Build-Pipeline"}}]},{"text":" to know about the Azure DevOps Build Pipeline configuration. This must be configured prior to configuring the FlexDeploy workflows and project properties.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Execution","type":"text"}]},{"type":"paragraph","content":[{"text":"Initiate Build on the selected Package.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note: The ARM templates are published to Azure DevOps Feed as Artifacts with the package name as a keyword in it. Example: ","type":"text"},{"text":"--json ","type":"text","marks":[{"type":"em"}]},{"text":"& ","type":"text"},{"text":"--arm","type":"text","marks":[{"type":"em"}]},{"text":". Now Microsoft has certain restrictions on the naming of the Azure Artifacts, hence please follow the guide before you name the package that you create in FD or else adjust your workflow to be in compliance. ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://learn.microsoft.com/en-us/azure/devops/organizations/settings/naming-restrictions?view=azure-devops"}}]}]},{"type":"paragraph","content":[{"text":"The ARM template is now uploaded to repository","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1531,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1906,"alt":"image-20241021-163546.png","id":"153391a4-5839-4b58-a265-06ee595be138","collection":"contentId-10630955144","type":"file","height":395}}]},{"type":"paragraph","content":[{"text":"The folder name is following the naming we selected for the package name in FD. If any parameter is to be added/updated or some other manipulation is to be done in the ARM template json in terms of variables or parameters, it can be done. But the integrity of the ARM template should remain intact.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Workflow configuration for fetching the ARM template from the repository and initiate the Synapse Release pipeline","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Build Workflow:","type":"text"}]},{"type":"expand","attrs":{"title":"SynapsePackageBuildARM"},"content":[{"type":"codeBlock","content":[{"text":"\n\n SynapsePackageBuildARM\n \n \n \n execute\n 1\n \n FlexagonShellPlugin\n execute\n false\n v2\n false\n true\n \n All\n \n Any\n \n \n FDSHELL_INP_CODE_SNIPPET\n Text\n false\n String\n # Define the name of the zip file to be created\nZIP_NAME=$FD_PROJECT_NAME.zip\n\nmkdir -p $FD_TEMP_DIR/ARMTEMPLATES\nfind $FD_TEMP_DIR -type f -name "Template*.json" -exec cp {} $FD_TEMP_DIR/ARMTEMPLATES \\;\ncd $FD_TEMP_DIR/ARMTEMPLATES\n\n# Find and zip all Template*.json files into a single zip file\nzip "$ZIP_NAME" *\ncp $FD_TEMP_DIR/ARMTEMPLATES/$ZIP_NAME $FD_ARTIFACTS_DIR\n\necho "Zip created and moved to artifacts."\n\n \n \n FDSHELL_INP_STOP_ON_ERROR\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_DISABLE_ECHO\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_RESTRICT_ENVIRONMENT\n Text\n false\n String\n \n \n FDSHELL_INP_NO_SECURE_VARIABLES\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_LOCK\n Text\n false\n String\n \n \n \n \n \n \n \n \n\n","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy Workflow:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1206,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1206,"alt":"image-20241022-075839.png","id":"7fb074ba-b4e5-4822-ae69-4fdd8c963bb2","collection":"contentId-10630955144","type":"file","height":623}}]},{"type":"expand","attrs":{"title":"SynapsePackageDeployARM"},"content":[{"type":"codeBlock","content":[{"text":"\n\n SynapsePackageDeployARM\n \n \n \n FINALVERSION\n String\n true\n false\n \n \n RELEASE_ID\n String\n true\n false\n \n \n ENVIRONMENT_ID\n String\n true\n false\n \n \n RELEASE_URL\n String\n true\n false\n \n \n PKG_NAME\n String\n true\n false\n \n \n ENV_DETAILS\n String\n true\n false\n \n \n \n \n execute\n 1\n \n FlexagonShellPlugin\n execute\n false\n v2\n true\n false\n \n All\n \n Any\n \n \n FDSHELL_INP_CODE_SNIPPET\n Text\n false\n String\n mkdir -p $FD_TEMP_DIR/ARMFiles\nunzip $FD_ARTIFACTS_DIR/*.zip -d $FD_TEMP_DIR/ARMFiles\n \n \n FDSHELL_INP_STOP_ON_ERROR\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_DISABLE_ECHO\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_RESTRICT_ENVIRONMENT\n Text\n false\n String\n \n \n FDSHELL_INP_NO_SECURE_VARIABLES\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_LOCK\n Text\n false\n String\n \n \n \n \n \n \n \n \n propertyReplacement\n 2\n \n FlexagonFilePlugin\n propertyReplacement\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDFILE_INP_SOURCE_PATH\n Expression\n false\n String\n \n FD_TEMP_DIR + "/ARMFiles"\n \n \n \n FDFILE_INP_FILE_FILTER\n Text\n false\n String\n \n \n FDFILE_INP_FILE_FILTER_EXCLUDED\n Text\n false\n String\n \n \n \n \n \n \n \n \n Assign\n 3\n \n \n PACKAGE_VERSION.substring(0,PACKAGE_VERSION.lastIndexOf(".") +1) + FD_WORKFLOW_EXECUTION_ID\n \n FINALVERSION\n \n \n \n publishArtifacts\n 4\n \n FlexagonAzurePlugin\n publishArtifacts\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDAZ_DEVOPS_INP_FEED\n Expression\n false\n String\n \n FEED_NAME\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_NAME\n Expression\n false\n String\n \n (FD_PACKAGE_NAME + "-" + PACKAGE_NAME + "-" + FD_ENVIRONMENT_CODE).toLowerCase()\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_VERSION\n Expression\n false\n String\n \n FINALVERSION\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_DESCRIPTION\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_PROJECT_NAME\n Expression\n false\n String\n \n PROJECT_NAME\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_PATH\n Expression\n false\n String\n \n FD_TEMP_DIR + "/ARMFiles"\n \n \n \n FDAZ_DEVOPS_INP_ADDITIONAL_PARAMS\n Text\n false\n String\n \n \n \n \n \n FDAZ_DEVOPS_OUT_ERR\n \n \n FDAZ_DEVOPS_OUT_RESP\n \n \n \n \n \n \n createRelease\n 5\n \n FlexagonAzurePlugin\n createRelease\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDAZ_DEVOPS_INP_RELEASE_DEFINITION_ID\n Expression\n false\n String\n \n RELEASE_DEFINITION_ID\n \n \n \n FDAZ_DEVOPS_INP_ARTIFACTS_PAYLOAD\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_PROJECT_NAME\n Expression\n false\n String\n \n PROJECT_NAME\n \n \n \n FDAZ_DEVOPS_INP_VARIABLES_LIST\n Expression\n false\n String\n \n "{\\"feedName\\": {\\"value\\": \\"" + PROJECT_NAME + "/" + FEED_NAME + "\\"},\\"packageName\\": {\\"value\\": \\"" + (FD_PACKAGE_NAME + "-" + PACKAGE_NAME + "-" + FD_ENVIRONMENT_CODE).toLowerCase() + "\\"},\\"packageVersion\\": {\\"value\\": \\"" + FINALVERSION + "\\"}}"\n \n \n \n FDAZ_DEVOPS_INP_PROPERTIES\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_MANUAL_ENVIRONMENTS\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_RELEASE_STATUS_CHECK\n Text\n false\n Boolean\n false\n \n \n FDAZ_DEVOPS_INP_PARTIALLY_SUCCEEDED_ENVIRONMENTS\n Text\n false\n String\n \n \n \n \n \n FDAZ_DEVOPS_OUT_RESP\n \n \n FDAZ_DEVOPS_OUT_RELEASE_WEB_URL\n \n \n FDAZ_DEVOPS_OUT_REL_ENV_STAGE_DETAILS\n ENV_DETAILS\n \n \n FDAZ_DEVOPS_OUT_RELEASE_ID\n RELEASE_ID\n \n \n \n \n \n \n parseJson\n 6\n \n FlexagonXPathPlugin\n parseJson\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDP_SOURCE\n Expression\n false\n String\n \n ENV_DETAILS\n \n \n \n FDP_XPATH\n Expression\n false\n String\n \n '$..[?(@.name==\\''+FD_ENVIRONMENT_NAME+'\\')].id'\n \n \n \n \n \n \n FDP_VALUE\n ENVIRONMENT_ID\n \n \n \n \n \n \n updateReleaseEnvStatus\n 7\n \n FlexagonAzurePlugin\n updateReleaseEnvStatus\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDAZ_DEVOPS_INP_RELEASE_ID\n Expression\n false\n Integer\n \n RELEASE_ID\n \n \n \n FDAZ_DEVOPS_INP_RELEASE_ENVIRONMENT_ID\n Expression\n false\n Integer\n \n ENVIRONMENT_ID.substring(1,ENVIRONMENT_ID.length()-1)\n \n \n \n FDAZ_DEVOPS_INP_PROJECT_NAME\n Expression\n false\n String\n \n PROJECT_NAME\n \n \n \n FDAZ_DEVOPS_INP_RELEASE_ENVIRONMENT_STATUS\n Text\n false\n String\n InProgress\n \n \n FDAZ_DEVOPS_INP_VARIABLES_LIST\n Expression\n false\n String\n \n ENVIRONMENT_VARIABLES_LIST\n \n \n \n FDAZ_DEVOPS_INP_RELEASE_COMMENT\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_SCHEDULED_DEPLOYMENT_TIME\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_REL_ENV_STATUS_CHECK\n Text\n false\n Boolean\n true\n \n \n FDAZ_DEVOPS_INP_PARTIALLY_SUCCEEDED_STATUS_CHECK\n Text\n false\n Boolean\n false\n \n \n \n \n \n FDAZ_DEVOPS_OUT_RESP\n \n \n FDAZ_DEVOPS_OUT_REL_ENV_WEB_URL\n RELEASE_URL\n \n \n \n \n \n \n packageExecute\n 8\n \n FlexagonShellPlugin\n packageExecute\n false\n v2\n true\n false\n \n All\n \n Any\n \n \n FDSHELL_INP_CODE_SNIPPET\n Text\n false\n String\n echo "Deployment Completed"\n \n \n FDSHELL_INP_STOP_ON_ERROR\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_DISABLE_ECHO\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_RESTRICT_ENVIRONMENT\n Text\n false\n String\n \n \n FDSHELL_INP_NO_SECURE_VARIABLES\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_PERFORM_PROPERTY_REPLACEMENT\n Text\n false\n Boolean\n false\n \n \n \n \n \n \n \n \n\n","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Project Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a Project by choosing the Classification: Package-based and Project Types as Generic","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":870,"alt":"image-20240329-064826.png","id":"57e026eb-20c0-4f6b-a7a4-9d1a44b106bb","collection":"contentId-10630955144","type":"file","height":309}}]},{"type":"paragraph","content":[{"text":"Once it is created the Source Control needs to be configured, so that we can discover the files from the respective repository. This time the source control is the one where we have uploaded the ARM template.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1257,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1697,"alt":"image-20241021-164349.png","id":"b46274aa-9a27-42e9-8fab-742c7f21bb4e","collection":"contentId-10630955144","type":"file","height":800}}]},{"type":"paragraph","content":[{"text":"Discover the files using File Catalog tab","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1407,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1679,"alt":"image-20241021-164500.png","id":"00ffc4a3-60f2-4e1a-b988-f1410d3927d3","collection":"contentId-10630955144","type":"file","height":490}}]},{"type":"paragraph","content":[{"text":"Now we can create Package upon selecting specific ARM template which is to be deployed to the Target Synapse Workspace.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1291,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1746,"alt":"image-20241021-164628.png","id":"7e690841-660e-493a-9db1-e6b83c8ee438","collection":"contentId-10630955144","type":"file","height":422}}]},{"type":"paragraph","content":[{"text":"Click on the Configuration tab, select General and update the Build and Deploy workflows with respective Target group.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1219,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1671,"alt":"image-20241021-164829.png","id":"2da4f1ab-33fa-48f0-a3ef-ba3e50105136","collection":"contentId-10630955144","type":"file","height":813}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Parameterizing the values","type":"text"}]},{"type":"paragraph","content":[{"text":"There are many ways to do environment specific parameter value customization. 1) Using Replacement configuration of Project 2) Specifying the parameter as ${{}} in the source json file itself or the generated ARM template 3) Edit the generated ARM template to include the parameter as ARM template parameter. We will show option 2 in the following example.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Replacement configuration on Project","type":"text"}]},{"type":"paragraph","content":[{"text":"Starting 7.0 we have a new feature that allows us to replace a string in any file with another string based on as it is executed to different environment. Ref: ","type":"text"},{"text":"Replacements - FlexDeploy 7.0 - Confluence (atlassian.net)","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10419863555"}}]}]},{"type":"paragraph","content":[{"text":"For our use-case a specific parameter as below is created in the Linked Service:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1204,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1628,"alt":"image-20241021-165531.png","id":"f79943bd-cdc9-4031-9b77-862ab35aa9d4","collection":"contentId-10630955144","type":"file","height":766}}]},{"type":"paragraph","content":[{"text":"When this source workspace is integrated with GIT, the linked service json file gets auto-synced there. One can edit the parameter manually to hold the target group property as","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":654,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":654,"alt":"image-20241021-170147.png","id":"bafd03e1-799c-433d-81ee-83563a31bff9","collection":"contentId-10630955144","type":"file","height":546}}]},{"type":"paragraph","content":[{"text":"Once this is done as shown earlier, the target group property will take care of replacing it with right environment specific value during deployment.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Target Group configuration","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1275,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1741,"alt":"image-20241021-152727.png","id":"190cc06c-5168-4aaa-abda-11ad44d8fd28","collection":"contentId-10630955144","type":"file","height":347}}]},{"type":"paragraph","content":[{"text":"Build","type":"text","marks":[{"type":"strong"}]},{"text":" = for build execution; ","type":"text"},{"text":"UAT","type":"text","marks":[{"type":"strong"}]},{"text":" = for deploy execution.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Build","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":656,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":656,"alt":"image-20241021-153546.png","id":"206c4147-d026-4d75-aa23-60a648b3275e","collection":"contentId-10630955144","type":"file","height":312}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"UAT","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":652,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":652,"alt":"image-20241021-153921.png","id":"084a1248-0178-405a-9c5f-ec5b562372c6","collection":"contentId-10630955144","type":"file","height":586}}]},{"type":"paragraph","content":[{"text":"The Environment Specific Variables field controls the target workspace name and several other environment specific parameters. To know more follow this ","type":"text"},{"text":"link","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10563911951/Azure+Synapse+Workspace+Artifacts+Deployment#Target-Group-Properties"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow this ","type":"text"},{"text":"link","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10563911951/Azure+Synapse+Workspace+Artifacts+Deployment#Release-Pipeline"}}]},{"text":" to know about the Azure DevOps Release Pipeline configuration. This must be configured prior to configuring the FlexDeploy workflows and project properties.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Execution","type":"text"}]},{"type":"paragraph","content":[{"text":"Initiate Build on the selected Package. Once done initiate the Deploy. Build produces the ARM templates as a zip bundle, which Deploy further passes on to the Azure DevOps Release Pipeline to deploy to target workspace.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1095,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1749,"alt":"image-20241021-170702.png","id":"45e28f07-2b24-4776-979a-b78272584c09","collection":"contentId-10630955144","type":"file","height":793}}]},{"type":"paragraph","content":[{"text":"The Output tab of createRelease step would show the Azue DevOps Release URL to further see the log in more detail:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1199,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1595,"alt":"image-20241021-170932.png","id":"efb3553e-a278-4580-a9ae-a6a07b4c2355","collection":"contentId-10630955144","type":"file","height":372}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Post deployment if we verify the Linked Service in UAT workspace, we see the updated values in there.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Flow (Approach B)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Azure Devops pipeline configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"More information is ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10563911951"}}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1528,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1635,"alt":"image-20241021-154937.png","id":"3070a350-f531-452d-be04-b13e69c22092","collection":"contentId-10630955144","type":"file","height":885}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1467,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1638,"alt":"image-20241021-155023.png","id":"bdec79a6-d6e8-4f15-95a1-ed637fc8e490","collection":"contentId-10630955144","type":"file","height":877}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Workflow configuration","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Build Workflow:","type":"text"}]},{"type":"expand","attrs":{"title":"SynapsePackageBuildJSON"},"content":[{"type":"codeBlock","content":[{"text":"\n\n SynapsePackageBuildJSON\n \n \n \n execute\n 1\n \n FlexagonShellPlugin\n execute\n false\n v2\n false\n true\n \n All\n \n Any\n \n \n FDSHELL_INP_CODE_SNIPPET\n Text\n false\n String\n # Define the name of the zip file to be created\nZIP_NAME=$FD_PROJECT_NAME.zip\n\n# Find and zip all Template*.json files into a single zip file\nzip -r "$ZIP_NAME" . -i *.json\ncp $FD_TEMP_DIR/$ZIP_NAME $FD_ARTIFACTS_DIR\n\necho "Zip created and moved to artifacts."\n\n \n \n FDSHELL_INP_STOP_ON_ERROR\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_DISABLE_ECHO\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_RESTRICT_ENVIRONMENT\n Text\n false\n String\n \n \n FDSHELL_INP_NO_SECURE_VARIABLES\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_LOCK\n Text\n false\n String\n \n \n \n \n \n \n \n \n\n","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Deploy Workflow:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1207,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1207,"alt":"image-20241022-080544.png","id":"727322ae-8af4-471f-b1c9-4669bff4fa1b","collection":"contentId-10630955144","type":"file","height":611}}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note: Here ${{","type":"text"},{"text":"BLOBWSPACE_TARGET","type":"text","marks":[{"type":"em"}]},{"text":"}} is configured in the input json, which is why we are configuring it here as Target properties.","type":"text"}]}]},{"type":"expand","attrs":{"title":"SynapsePackageDeployJSON"},"content":[{"type":"codeBlock","content":[{"text":"\n\n SynapsePackageDeployJSON\n \n \n \n FINALVERSION\n String\n true\n false\n \n \n RELEASE_ID\n String\n true\n false\n \n \n ENVIRONMENT_ID\n String\n true\n false\n \n \n RELEASE_URL\n String\n true\n false\n \n \n PKG_NAME\n String\n true\n false\n \n \n ENV_DETAILS\n String\n true\n false\n \n \n \n \n execute\n 1\n \n FlexagonShellPlugin\n execute\n false\n v2\n true\n false\n \n All\n \n Any\n \n \n FDSHELL_INP_CODE_SNIPPET\n Text\n false\n String\n mkdir -p $FD_TEMP_DIR/JSONFiles\nunzip $FD_ARTIFACTS_DIR/*.zip -d $FD_TEMP_DIR/JSONFiles\n \n \n FDSHELL_INP_STOP_ON_ERROR\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_DISABLE_ECHO\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_RESTRICT_ENVIRONMENT\n Text\n false\n String\n \n \n FDSHELL_INP_NO_SECURE_VARIABLES\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_LOCK\n Text\n false\n String\n \n \n \n \n \n \n \n \n propertyReplacement\n 2\n \n FlexagonFilePlugin\n propertyReplacement\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDFILE_INP_SOURCE_PATH\n Expression\n false\n String\n \n FD_TEMP_DIR + "/JSONFiles"\n \n \n \n FDFILE_INP_FILE_FILTER\n Text\n false\n String\n \n \n FDFILE_INP_FILE_FILTER_EXCLUDED\n Text\n false\n String\n \n \n \n \n \n \n \n \n Assign\n 3\n \n \n PACKAGE_VERSION.substring(0,PACKAGE_VERSION.lastIndexOf(".") +1) + FD_WORKFLOW_EXECUTION_ID\n \n FINALVERSION\n \n \n \n publishArtifacts\n 4\n \n FlexagonAzurePlugin\n publishArtifacts\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDAZ_DEVOPS_INP_FEED\n Expression\n false\n String\n \n FEED_NAME\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_NAME\n Expression\n false\n String\n \n (FD_PACKAGE_NAME + "-" + ARTIFACTS_PACKAGE_NAME + "-" + FD_ENVIRONMENT_CODE).toLowerCase()\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_VERSION\n Expression\n false\n String\n \n FINALVERSION\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_DESCRIPTION\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_PROJECT_NAME\n Expression\n false\n String\n \n PROJECT_NAME\n \n \n \n FDAZ_DEVOPS_INP_PACKAGE_PATH\n Expression\n false\n String\n \n FD_TEMP_DIR + "/JSONFiles"\n \n \n \n FDAZ_DEVOPS_INP_ADDITIONAL_PARAMS\n Text\n false\n String\n \n \n \n \n \n FDAZ_DEVOPS_OUT_ERR\n \n \n FDAZ_DEVOPS_OUT_RESP\n \n \n \n \n \n \n createRelease\n 5\n \n FlexagonAzurePlugin\n createRelease\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDAZ_DEVOPS_INP_RELEASE_DEFINITION_ID\n Expression\n false\n String\n \n RELEASE_DEFINITION_ID\n \n \n \n FDAZ_DEVOPS_INP_ARTIFACTS_PAYLOAD\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_PROJECT_NAME\n Expression\n false\n String\n \n PROJECT_NAME\n \n \n \n FDAZ_DEVOPS_INP_VARIABLES_LIST\n Expression\n false\n String\n \n "{\\"feedName\\": {\\"value\\": \\"" + PROJECT_NAME + "/" + FEED_NAME + "\\"},\\"packageName\\": {\\"value\\": \\"" + (FD_PACKAGE_NAME + "-" + ARTIFACTS_PACKAGE_NAME + "-" + FD_ENVIRONMENT_CODE).toLowerCase() + "\\"},\\"packageVersion\\": {\\"value\\": \\"" + FINALVERSION + "\\"}}"\n \n \n \n FDAZ_DEVOPS_INP_PROPERTIES\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_MANUAL_ENVIRONMENTS\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_RELEASE_STATUS_CHECK\n Text\n false\n Boolean\n false\n \n \n FDAZ_DEVOPS_INP_PARTIALLY_SUCCEEDED_ENVIRONMENTS\n Text\n false\n String\n \n \n \n \n \n FDAZ_DEVOPS_OUT_RESP\n \n \n FDAZ_DEVOPS_OUT_RELEASE_WEB_URL\n \n \n FDAZ_DEVOPS_OUT_REL_ENV_STAGE_DETAILS\n ENV_DETAILS\n \n \n FDAZ_DEVOPS_OUT_RELEASE_ID\n RELEASE_ID\n \n \n \n \n \n \n parseJson\n 6\n \n FlexagonXPathPlugin\n parseJson\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDP_SOURCE\n Expression\n false\n String\n \n ENV_DETAILS\n \n \n \n FDP_XPATH\n Expression\n false\n String\n \n '$..[?(@.name==\\''+FD_ENVIRONMENT_NAME+'\\')].id'\n \n \n \n \n \n \n FDP_VALUE\n ENVIRONMENT_ID\n \n \n \n \n \n \n updateReleaseEnvStatus\n 7\n \n FlexagonAzurePlugin\n updateReleaseEnvStatus\n false\n v2\n false\n false\n \n All\n \n Any\n \n \n FDAZ_DEVOPS_INP_RELEASE_ID\n Expression\n false\n Integer\n \n RELEASE_ID\n \n \n \n FDAZ_DEVOPS_INP_RELEASE_ENVIRONMENT_ID\n Expression\n false\n Integer\n \n ENVIRONMENT_ID.substring(1,ENVIRONMENT_ID.length()-1)\n \n \n \n FDAZ_DEVOPS_INP_PROJECT_NAME\n Expression\n false\n String\n \n PROJECT_NAME\n \n \n \n FDAZ_DEVOPS_INP_RELEASE_ENVIRONMENT_STATUS\n Text\n false\n String\n InProgress\n \n \n FDAZ_DEVOPS_INP_VARIABLES_LIST\n Expression\n false\n String\n \n ENVIRONMENT_VARIABLES_LIST\n \n \n \n FDAZ_DEVOPS_INP_RELEASE_COMMENT\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_SCHEDULED_DEPLOYMENT_TIME\n Text\n false\n String\n \n \n FDAZ_DEVOPS_INP_REL_ENV_STATUS_CHECK\n Text\n false\n Boolean\n true\n \n \n FDAZ_DEVOPS_INP_PARTIALLY_SUCCEEDED_STATUS_CHECK\n Text\n false\n Boolean\n false\n \n \n \n \n \n FDAZ_DEVOPS_OUT_RESP\n \n \n FDAZ_DEVOPS_OUT_REL_ENV_WEB_URL\n RELEASE_URL\n \n \n \n \n \n \n packageExecute\n 8\n \n FlexagonShellPlugin\n packageExecute\n false\n v2\n true\n false\n \n All\n \n Any\n \n \n FDSHELL_INP_CODE_SNIPPET\n Text\n false\n String\n echo "Deployment Completed"\n \n \n FDSHELL_INP_STOP_ON_ERROR\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_DISABLE_ECHO\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_RESTRICT_ENVIRONMENT\n Text\n false\n String\n \n \n FDSHELL_INP_NO_SECURE_VARIABLES\n Text\n false\n Boolean\n false\n \n \n FDSHELL_INP_PERFORM_PROPERTY_REPLACEMENT\n Text\n false\n Boolean\n false\n \n \n \n \n \n \n \n \n\n","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Project Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a Project say ","type":"text"},{"text":"SelectiveJsonDeployment","type":"text","marks":[{"type":"em"}]},{"text":", by choosing the Classification: Package-based and Project Types as Generic","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":870,"alt":"image-20240329-064826.png","id":"57e026eb-20c0-4f6b-a7a4-9d1a44b106bb","collection":"contentId-10630955144","type":"file","height":309}}]},{"type":"paragraph","content":[{"text":"Once it is created the Source Control needs to be configured, so that we can discover the files from the respective repository.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: These files are from the GIT integrated workspace that we use in Synapse for DEV environment.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1248,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1587,"alt":"image-20241021-151308.png","id":"a1c71b3a-bc56-41fb-bbc4-fdc69b7160dd","collection":"contentId-10630955144","type":"file","height":709}}]},{"type":"paragraph","content":[{"text":"For example, this is how the source control in Project looks like:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1193,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1652,"alt":"image-20241021-151558.png","id":"d4f79a2e-964c-4319-b421-9e5d6c3ea586","collection":"contentId-10630955144","type":"file","height":845}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Project Properties","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1518,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1638,"alt":"image-20241021-153144.png","id":"a571af3e-ec72-43ae-a188-9a7ecb791fc5","collection":"contentId-10630955144","type":"file","height":823}}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note: These are the values from the Azure DevOps Feed, Project Name that you already have configured. We have explained their configuration more ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10563911951"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Discover the files using File Catalog tab","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1372,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1746,"alt":"image-20241021-151802.png","id":"e1b95995-e100-4554-a684-c131ff20209a","collection":"contentId-10630955144","type":"file","height":760}}]},{"type":"paragraph","content":[{"text":"Now we can create Package upon selecting specific files.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, here we chose two pipelines and a linked service to form the package called ","type":"text"},{"text":"abstractdemo","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1377,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1793,"alt":"image-20241021-151936.png","id":"1c252f34-852c-41a0-934a-7541a86c3d19","collection":"contentId-10630955144","type":"file","height":465}}]},{"type":"paragraph","content":[{"text":"Click on the Configuration tab, select General and map the Build and Deploy workflows along with respective Target group.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1392,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1723,"alt":"image-20241021-152244.png","id":"27541a9d-a94e-4cae-84e6-490032b41e9f","collection":"contentId-10630955144","type":"file","height":833}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Target Group configuration","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1275,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1741,"alt":"image-20241021-152727.png","id":"190cc06c-5168-4aaa-abda-11ad44d8fd28","collection":"contentId-10630955144","type":"file","height":347}}]},{"type":"paragraph","content":[{"text":"Build","type":"text","marks":[{"type":"strong"}]},{"text":" = for build execution; ","type":"text"},{"text":"UAT","type":"text","marks":[{"type":"strong"}]},{"text":" = for deploy execution.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Build","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":656,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":656,"alt":"image-20241021-153546.png","id":"206c4147-d026-4d75-aa23-60a648b3275e","collection":"contentId-10630955144","type":"file","height":312}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"UAT","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":652,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":652,"alt":"image-20241021-153921.png","id":"084a1248-0178-405a-9c5f-ec5b562372c6","collection":"contentId-10630955144","type":"file","height":586}}]},{"type":"paragraph","content":[{"text":"The Environment Specific Variables field controls the target workspace name and several other environment specific parameters. To know more follow this ","type":"text"},{"text":"link","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.atlassian.net/wiki/spaces/FD70/pages/10563911951/Azure+Synapse+Workspace+Artifacts+Deployment#Target-Group-Properties"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Execution","type":"text"}]},{"type":"paragraph","content":[{"text":"Initiate Build on the selected Package ","type":"text"},{"text":"abstractdemo","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"**Note: The ARM templates are published to Azure DevOps Feed as Artifacts with the package name as a keyword in it. Example: ","type":"text"},{"text":"--json-","type":"text","marks":[{"type":"em"}]},{"text":". Now Microsoft has certain restrictions on the naming of the Azure Artifacts, hence please follow the guide before you name the package that you create in FD or else adjust your workflow to be in compliance. ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://learn.microsoft.com/en-us/azure/devops/organizations/settings/naming-restrictions?view=azure-devops"}}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1275,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1751,"alt":"image-20241021-154021.png","id":"a78695ae-dcb1-45c9-89c7-ca55c664f543","collection":"contentId-10630955144","type":"file","height":589}}]},{"type":"paragraph","content":[{"text":"It creates the artifacts with the zip bundle of json files.","type":"text"}]},{"type":"paragraph","content":[{"text":"Initiate Deploy on the built version.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1467,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1783,"alt":"image-20241021-154218.png","id":"b519577c-c889-42e3-9876-b906d8a6a2ae","collection":"contentId-10630955144","type":"file","height":847}}]},{"type":"paragraph","content":[{"text":"Clicking on the createRelease step’s Output tab, you would find the release url of Azure DevOps Release pipeline. Navigating to that shows more log:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1401,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1401,"alt":"image-20241021-154753.png","id":"d4c52799-11ba-493e-92fd-46a205271c7f","collection":"contentId-10630955144","type":"file","height":507}}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported