{"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":"b5f682bf-d239-47b2-b6b3-43911631ea57"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"5c72a606-ecd5-47a3-8569-00834a7ca07a"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"This playbook provides step-by-step instructions for setting up an Azure deployment for the PO Box. It includes creating an ","type":"text"},{"text":"App Registration","type":"text","marks":[{"type":"strong"}]},{"text":", setting up a ","type":"text"},{"text":"storage account and file share","type":"text","marks":[{"type":"strong"}]},{"text":", and deploying an ","type":"text"},{"text":"Azure Container Instance (ACI)","type":"text","marks":[{"type":"strong"}]},{"text":" with necessary configurations.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Azure CLI installed and configured on your machine.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Azure subscription and resource group inside the subscription ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Necessary permissions in the Azure subscription to create resources.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Zilla token provided by Customer Success team ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Azure container registry login server and image name provided by Customer Success team","type":"text"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Deployment Options","type":"text"}]},{"type":"paragraph","content":[{"text":"Zilla provides the following mechanisms to allow you to deploy PO BOX to your Azure environment ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Option 1: Using Azure portal","type":"text"}]},{"type":"paragraph","content":[{"text":"This option provides a step by step guide on how to use the Azure Portal to set up the resources required to deploy PO BOX to your environment","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 1: Create App Registration","type":"text"}]},{"type":"paragraph","content":[{"text":"Login to ","type":"text"},{"text":"Azure portal","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://portal.azure.com/"}}]},{"text":" with admin user and click on ","type":"text"},{"text":"create a resource","type":"text","marks":[{"type":"code"}]},{"text":" and search of ","type":"text"},{"text":"App Registration -> New registration","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1319,"alt":"image-20241030-042216.png","id":"9fab4bde-190a-4f16-a975-d856e19155ff","collection":"contentId-3274178561","type":"file","height":994}}]},{"type":"paragraph","content":[{"text":"Fill the above details and click ","type":"text"},{"text":"Register","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1426,"alt":"image-20241030-042410.png","id":"b13bf058-2a40-48cc-8a77-a968e3005fb0","collection":"contentId-3274178561","type":"file","height":617}}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Store ","type":"text"},{"text":"Application (client) ID","type":"text","marks":[{"type":"code"}]},{"text":" for later use. You will also need to share this ","type":"text"},{"text":"Application (client) ID","type":"text","marks":[{"type":"code"}]},{"text":" with Customer Success team of Zilla so that they can allow the app to pull the image automatically later.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 2: Add Client Secret","type":"text"}]},{"type":"paragraph","content":[{"text":"Navigate to ","type":"text"},{"text":"Manage","type":"text","marks":[{"type":"code"}]},{"text":"-> ","type":"text"},{"text":"Certificates & secrets","type":"text","marks":[{"type":"code"}]},{"text":" and click on ","type":"text"},{"text":"New client secret","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Add Description and set Expires and click on ","type":"text"},{"text":"Add","type":"text","marks":[{"type":"code"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1658,"alt":"image-20241030-042630.png","id":"8fc4b171-b16b-4da2-9173-5c8d32b8cd24","collection":"contentId-3274178561","type":"file","height":997}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Keep ","type":"text"},{"text":"clientSecret","type":"text","marks":[{"type":"code"}]},{"text":" secret secure, as it will be used to authenticate the application.","type":"text"}]},{"type":"paragraph","content":[{"text":"You will not be able to retrieve this secret again after this step.Step 3: Create Storage Account","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 3: Create Storage Account","type":"text"}]},{"type":"paragraph","content":[{"text":"Create an Azure Storage Account to store the Zilla token provided by CS team","type":"text"}]},{"type":"paragraph","content":[{"text":"Login to ","type":"text"},{"text":"Azure portal","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://portal.azure.com/"}}]},{"text":" with admin user and click on ","type":"text"},{"text":"create a resource","type":"text","marks":[{"type":"code"}]},{"text":" and search of ","type":"text"},{"text":"`Storage accounts`","type":"text","marks":[{"type":"code"}]},{"text":"and click on ","type":"text"},{"text":"Create","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1474,"alt":"image-20241030-043305.png","id":"7cecc293-35ee-4a08-bc87-99f16a496e76","collection":"contentId-3274178561","type":"file","height":332}}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1333,"alt":"image-20241030-043404.png","id":"aec45528-9598-4133-9d8a-37a3545066da","collection":"contentId-3274178561","type":"file","height":998}}]},{"type":"paragraph","content":[{"text":"Fill the required details and click on ","type":"text"},{"text":"Review + create","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1334,"alt":"image-20241030-043539.png","id":"f35cd14f-a814-4bfa-a654-8605cbcc539b","collection":"contentId-3274178561","type":"file","height":992}}]},{"type":"paragraph","content":[{"text":"Review the details and click on ","type":"text"},{"text":"Create","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Once deployment is done. Click on ","type":"text"},{"text":"Go to reosurce","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 4: Create File Share","type":"text"}]},{"type":"paragraph","content":[{"text":"Navigate to ","type":"text"},{"text":"Data storage","type":"text","marks":[{"type":"code"}]},{"text":" → ","type":"text"},{"text":"File shares","type":"text","marks":[{"type":"code"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1373,"alt":"image-20241030-043948.png","id":"4f523bba-2397-4753-8ba7-56c6e63cec39","collection":"contentId-3274178561","type":"file","height":981}}]},{"type":"paragraph","content":[{"text":" Click on ","type":"text"},{"text":"+ File share","type":"text","marks":[{"type":"code"}]},{"text":" to add new file share","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1383,"alt":"image-20241030-044340.png","id":"2522d9a1-11cc-4732-89e6-c5d09ce9ee93","collection":"contentId-3274178561","type":"file","height":1002}}]},{"type":"paragraph","content":[{"text":"Add New file share name and details and click on ","type":"text"},{"text":"Review + create","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 5: Create Zilla Directory and Upload Token","type":"text"}]},{"type":"paragraph","content":[{"text":"Once create, navigate to ","type":"text"},{"text":"Browse","type":"text","marks":[{"type":"code"}]},{"text":" → ","type":"text"},{"text":"Add dirctory","type":"text","marks":[{"type":"code"}]},{"text":" named ","type":"text"},{"text":"Zilla","type":"text","marks":[{"type":"code"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1376,"alt":"image-20241030-044541.png","id":"cb08697c-81c4-4c2b-a601-29b153e3f26c","collection":"contentId-3274178561","type":"file","height":644}}]},{"type":"paragraph","content":[{"text":"Create two directories named ","type":"text"},{"text":"pobox-config","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"pobox-output","type":"text","marks":[{"type":"code"}]},{"text":" under ","type":"text"},{"text":"Zilla","type":"text","marks":[{"type":"code"}]},{"text":" and upload Zilla API key provided by Customer Support team inside ","type":"text"},{"text":"pobox-config","type":"text","marks":[{"type":"code"}]},{"text":" folder ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1416,"alt":"image-20241030-044718.png","id":"dbf91f01-1ab3-495a-9d86-a3b4e7776d16","collection":"contentId-3274178561","type":"file","height":759}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 6: Create Azure Container Instance","type":"text"}]},{"type":"paragraph","content":[{"text":"Above created app registration should be authenticated as per Step 4 and given ","type":"text"},{"text":"AcrPull","type":"text","marks":[{"type":"code"}]},{"text":" access to repository by Customer Success team ","type":"text"}]},{"type":"paragraph","content":[{"text":"Deploy an Azure Container Instance and mount the file share created earlier.","type":"text"}]},{"type":"codeBlock","content":[{"text":"az container create \\\n --resource-group \\\n --name \\\n --image 'zillapobox.azurecr.io/zinc:latest' \\\n --restart-policy OnFailure \\\n --environment-variables ZILLA_URL='https://app.zillasecurity.com' \\\n TENANT_DOMAIN='' \\\n POLLING_INTERVAL='30' \\\n SEND_LOGS_TO_BACKEND='true' \\\n USE_FILE_SYSTEM='true' \\\n SECRETS_DIRECTORY_PATH='/mnt/Zilla/pobox-config' \\\n STORAGE_DIRECTORY_PATH='/mnt/Zilla/pobox-output' \\\n --registry-login-server \\\n --registry-username \\\n --registry-password '' \\\n --azure-file-volume-share-name zilla-pobox-volume \\\n --azure-file-volume-account-name \\\n --azure-file-volume-account-key '' \\\n --azure-file-volume-mount-path /mnt","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Image","type":"text","marks":[{"type":"code"}]},{"text":": zillapobox.azurecr.io/zinc:latest","type":"text"}]},{"type":"paragraph","content":[{"text":"registry login server","type":"text","marks":[{"type":"code"}]},{"text":": zillapobox.azurecr.io","type":"text"}]},{"type":"paragraph","content":[{"text":"registry user name","type":"text","marks":[{"type":"code"}]},{"text":" : Application Id noted in Step 1 ","type":"text"}]},{"type":"paragraph","content":[{"text":"registry password","type":"text","marks":[{"type":"code"}]},{"text":" : Secret noted in Step 2 ","type":"text"}]},{"type":"paragraph","content":[{"text":"Azure storage account name","type":"text","marks":[{"type":"code"}]},{"text":" : Secret noted in Step 3 ","type":"text"}]},{"type":"paragraph","content":[{"text":"Azure storage account access key","type":"text","marks":[{"type":"code"}]},{"text":" : Can be obtained from Storage Account | Security + Networking | Access Keys","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 7: Create Logic app to restart container","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a logic app to restart a container every 24 hours to pull latest zinc image","type":"text"}]},{"type":"paragraph","content":[{"text":"Login to ","type":"text"},{"text":"Azure portal","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://portal.azure.com/"}}]},{"text":" with admin user and click on ","type":"text"},{"text":"create a resource","type":"text","marks":[{"type":"code"}]},{"text":" and search of ","type":"text"},{"text":"Logic Apps ","type":"text","marks":[{"type":"code"}]},{"text":"and click on ","type":"text"},{"text":"Add","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Select hosting option and proceed ","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1671,"alt":"image-20241030-051423.png","id":"e95011d7-a064-4e14-b0f3-455539a42a36","collection":"contentId-3274178561","type":"file","height":988}}]},{"type":"paragraph","content":[{"text":"Fill the details and click ","type":"text"},{"text":"Review and create","type":"text","marks":[{"type":"code"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1338,"alt":"image-20241030-051508.png","id":"e42a5722-91bb-4a64-bd3e-e549467b9d94","collection":"contentId-3274178561","type":"file","height":1010}}]},{"type":"paragraph","content":[{"text":"Once deployed click on ","type":"text"},{"text":"Go to resource","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Navigate to ","type":"text"},{"text":"Development Tools","type":"text","marks":[{"type":"code"}]},{"text":" → ","type":"text"},{"text":"Logic app designer","type":"text","marks":[{"type":"code"}]},{"text":" → ","type":"text"},{"text":"Add a trigger","type":"text","marks":[{"type":"code"}]},{"text":" and search for ","type":"text"},{"text":"Recurrence","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Click on ","type":"text"},{"text":"Trigger","type":"text","marks":[{"type":"code"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1660,"alt":"image-20241030-052901.png","id":"4d2edd07-fe9a-428c-9f49-771b5faed351","collection":"contentId-3274178561","type":"file","height":994}}]},{"type":"paragraph","content":[{"text":"Fill the details as per daily ACI restart time","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1676,"alt":"image-20241030-053058.png","id":"b51817d1-3b64-41fb-a39a-d9ba87f78b12","collection":"contentId-3274178561","type":"file","height":952}}]},{"type":"paragraph","content":[{"text":"Add and action","type":"text","marks":[{"type":"code"}]},{"text":" against the trigger ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1409,"alt":"image-20241030-053208.png","id":"17f758a2-8a06-4f87-8933-47c3e94650ff","collection":"contentId-3274178561","type":"file","height":978}}]},{"type":"paragraph","content":[{"text":"Search for ","type":"text"},{"text":"Container instance","type":"text","marks":[{"type":"code"}]},{"text":" and select action ","type":"text"},{"text":"Start containers in a container group","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1666,"alt":"image-20241030-054037.png","id":"483c77db-51d5-4a73-9c64-94365f4580dc","collection":"contentId-3274178561","type":"file","height":967}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Sign in","type":"text","marks":[{"type":"code"}]},{"text":" and fill the details of container instance ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1641,"alt":"image-20241030-054749.png","id":"337e7f4b-8333-407a-801c-713a274f1d10","collection":"contentId-3274178561","type":"file","height":980}}]},{"type":"paragraph","content":[{"text":"Save","type":"text","marks":[{"type":"code"}]},{"text":" the trigger and action.","type":"text"},{"type":"hardBreak"},{"text":"Run history can be monitored to check the logs ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Option 2: Execute CLI commands","type":"text"}]},{"type":"paragraph","content":[{"text":"This option requires you to execute the following commands (in order) to set up the resources required to deploy PO BOX to your environment","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 1: Create App Registration","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a new App Registration in your Azure Active Directory. This will enable authentication for your application. This app will be given ","type":"text"},{"text":"acrPull","type":"text","marks":[{"type":"code"}]},{"text":" role to pull latest ZINC image","type":"text"}]},{"type":"codeBlock","content":[{"text":"az ad app create --display-name \"zilla-pobox-\" \\\n --sign-in-audience \"AzureADMultipleOrgs\" \\\n --web-redirect-uris \"https://app.zillasecurity.com\"\n --query \"appId\" --output tsv","type":"text"}]},{"type":"paragraph","content":[{"text":"Replace","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" with your actual tenant name or domain.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Store ","type":"text"},{"text":"Application (client) ID","type":"text","marks":[{"type":"code"}]},{"text":" for later use. You will also need to share this ","type":"text"},{"text":"Application (client) ID","type":"text","marks":[{"type":"code"}]},{"text":" with Customer Success team of Zilla so that they can allow the app to pull the image automatically later.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 2: Add Client Secret","type":"text"}]},{"type":"paragraph","content":[{"text":"Generate a client secret (password) for the App Registration. This secret will be used for authentication.","type":"text"}]},{"type":"codeBlock","content":[{"text":"clientSecret=$(az ad app credential reset --id \"$appId\" \\\n --append --display-name \"password\" \\\n --query \"password\" --output tsv)\necho \"Client Secret: $clientSecret\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Keep ","type":"text"},{"text":"clientSecret","type":"text","marks":[{"type":"code"}]},{"text":" secret secure, as it will be used to authenticate the application.","type":"text"}]},{"type":"paragraph","content":[{"text":"You will not be able to retrieve this secret again after this step.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 3: Create Storage Account","type":"text"}]},{"type":"paragraph","content":[{"text":"Create an Azure Storage Account to store the Zilla token provided by CS team","type":"text"}]},{"type":"codeBlock","content":[{"text":"az storage account create \\--name zillapoboxstorage \\--resource-group \\--location eastus \\--sku Standard_GRS \\--kind StorageV2 \\--default-action Allow","type":"text"}]},{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" with your actual resource group name ","type":"text"},{"type":"hardBreak"},{"text":"Make sure it exists or create it if necessary.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 4: Create File Share","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a file share within the storage account to store the Zilla token.","type":"text"}]},{"type":"codeBlock","content":[{"text":"az storage share create \\\n --name zilla-pobox-volume \\\n --account-name zillapoboxstorage","type":"text"}]},{"type":"paragraph","content":[{"text":"File Share Name: This name will be used to mount the file share later. ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 5: Create Zilla Directory and Upload Token","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a directory in the file share and upload the Zilla token provided by the Customer Success team. ","type":"text"}]},{"type":"codeBlock","content":[{"text":"# Create the Zilla directory\naz storage directory create \\\n --name \"Zilla\" \\\n --share-name \"zilla-pobox-volume\" \\\n --account-name \"zillapoboxstorage\"\n\n# Create the pobox-config directory inside Zilla\naz storage directory create \\\n --name \"Zilla/pobox-config\" \\\n --share-name \"zilla-pobox-volume\" \\\n --account-name \"zillapoboxstorage\"\n\n# Create the pobox-output directory inside Zilla\naz storage directory create \\\n --name \"Zilla/pobox-ouput\" \\\n --share-name \"zilla-pobox-volume\" \\\n --account-name \"zillapoboxstorage\"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 6: Create Azure Container Instance","type":"text"}]},{"type":"paragraph","content":[{"text":"Above created app registration should be authenticated as per Step 4 and given ","type":"text"},{"text":"AcrPull","type":"text","marks":[{"type":"code"}]},{"text":" access to repository by CS team ","type":"text"}]},{"type":"paragraph","content":[{"text":"Deploy an Azure Container Instance and mount the file share created earlier.","type":"text"}]},{"type":"codeBlock","content":[{"text":"az container create \\ \n --resource-group \\\n --name zillapobox \\\n --image \\ \n --restart-policy OnFailure \\\n --environment-variables ZILLA_URL='https://app.zillasecurity.com' \\\n TENANT_DOMAIN='' \\ #tenant domain\n POLLING_INTERVAL='30' \\\n SEND_LOGS_TO_BACKEND='true' \\\n USE_FILE_SYSTEM='true' \\\n SECRETS_DIRECTORY_PATH='/mnt/Zilla/pobox-config' \\\n STORAGE_DIRECTORY_PATH='/mnt/Zilla/pobox-output' \\\n --registry-login-server \\ \n --registry-username \\ \n --registry-password \\ \n --azure-file-volume-share-name zilla-pobox-volume \\\n --azure-file-volume-account-name zillapoboxstorage \\\n --azure-file-volume-account-key \n --azure-file-volume-mount-path /mnt/Zilla","type":"text"}]},{"type":"paragraph","content":[{"text":"registry-username","type":"text","marks":[{"type":"code"}]},{"text":": Use the ","type":"text"},{"text":"App registration Id","type":"text","marks":[{"type":"code"}]},{"text":" from Step 1.","type":"text"}]},{"type":"paragraph","content":[{"text":"registry-password","type":"text","marks":[{"type":"code"}]},{"text":": Use the ","type":"text"},{"text":"App registration password","type":"text","marks":[{"type":"code"}]},{"text":" from Step 2.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 7: Create Logic app to restart container","type":"text"}]},{"type":"paragraph","content":[{"text":"This step needs to be done manually. Refer to Step 6: Create Logic app to restart container. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Option 3: Execute Power-shell script","type":"text"}]},{"type":"paragraph","content":[{"text":"This option allows you to use the Powershell scripts supplied by Zilla to quickly set up the resources required to deploy PO BOX to your environment","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Prerequisite: Powershell must be installed in the instance","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Powershell must be installed in your instance to execute Powershell scripts. You can download it from the official Microsoft site.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 1: Login to Azure","type":"text"}]},{"type":"paragraph","content":[{"text":"Login to Azure using command: ","type":"text"},{"text":"az login","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 2: Select the subscription","type":"text"}]},{"type":"paragraph","content":[{"text":"You will be prompted to select the subscription in which want to create resources. Here is a sample screenshot","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1105,"alt":"image-20241030-165344.png","id":"7ebe9d04-0928-4e4e-a4cc-675eb234f1de","collection":"contentId-3274178561","type":"file","height":616}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 3: Run createAppRegistration.ps1 (attached)","type":"text"}]},{"type":"paragraph","content":[{"text":"Before running the ","type":"text"},{"text":"createAppRegistration.ps1","type":"text","marks":[{"type":"code"}]},{"text":" script, ensure the ","type":"text"},{"text":"config_createAappRegistration.json","type":"text","marks":[{"type":"code"}]},{"text":" (attached) file is set up with the necessary values. This file should include any parameters required for the App Registration process.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"resourceGroupName\": \"\",\n \"storageAccountName\": \"zillapoboxstorage\",\n \"fileShareName\": \"zilla-pobox-volume\",\n \"appRegistrationName\": \"zillapobox-\",\n \"location\": \"\" \n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open PowerShell and navigate to the directory where the ","type":"text"},{"text":"createAppRegistration.ps1","type":"text","marks":[{"type":"code"}]},{"text":" script is located.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Execute the script by running the following command: ","type":"text"},{"text":".\\createAppRegistration.ps1","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"The script will create an App Registration in Azure and mount the necessary storage.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Once the ","type":"text"},{"text":"createAppRegistration.ps1","type":"text","marks":[{"type":"code"}]},{"text":" script has completed, you will need to update the ","type":"text"},{"text":"config_aci.json","type":"text","marks":[{"type":"code"}]},{"text":" file (attached) to include the app registration Id and secret generated in this previous step.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also, the Customer Success team needs to Authorise the application created above so that it can access Zilla’s Azure Container Registry for which they will need the app registration id","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Refer to readme.txt file under the folder ","type":"text"},{"text":"azure","type":"text","marks":[{"type":"code"}]},{"text":" share by Customer Success team and execute Powershell script as guided ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 4: Run createACI.ps1 (attached)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Before running the ","type":"text"},{"text":"createACI.ps1","type":"text","marks":[{"type":"code"}]},{"text":" script, ensure the ","type":"text"},{"text":"config_createACI.json","type":"text","marks":[{"type":"code"}]},{"text":" (attached) file is set up with the necessary values.","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"tenantName\": \"\",\n \"resourceGroupName\": \"\",\n \"storageAccountName\": \"zillapoboxstorage\",\n \"fileShareName\": \"zilla-pobox-volume\",\n \"containerInstanceName\": \"zillapobox\",\n \"imageName\": \"/zinc\",\n \"registryLoginServer\": \"\",\n \"appRegistrationName\": \"zillapobox-\",\n \"appId\": \"\",\n \"clientSecret\": \"\",\n \"location\": \"\",\n \"subscriptionId\": \"\"\n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open PowerShell and navigate to the directory where the ","type":"text"},{"text":"createACI.ps1","type":"text","marks":[{"type":"code"}]},{"text":" script is located.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Execute the script by running the following command: ","type":"text"},{"text":".\\createACI.ps1","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"After following the above steps, you should have successfully created an Azure App Registration and an Azure Container Instance.","type":"text"}]},{"type":"paragraph","content":[{"text":"Make sure to check the Azure portal for confirmation of above created resources.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Step 5: Create Logic app to restart container","type":"text"}]},{"type":"paragraph","content":[{"text":"This step needs to be done manually. Refer to Step 6: Create Logic app to restart container.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Attachments","type":"text"}]},{"type":"paragraph"},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"3a087214-5c77-4abd-8838-c12e25898249","collection":"contentId-3274178561","type":"file"}},{"type":"media","attrs":{"id":"ec10e3ee-df30-4f6a-a456-549f871734c3","collection":"contentId-3274178561","type":"file"}},{"type":"media","attrs":{"id":"5f31d2cd-0a65-4f9e-bf2f-6daf599ec5f0","collection":"contentId-3274178561","type":"file"}},{"type":"media","attrs":{"id":"d5d4e332-9f94-400b-95e9-bf75d541870f","collection":"contentId-3274178561","type":"file"}},{"type":"media","attrs":{"id":"3531c5b3-1ac1-4b1f-b3b1-d892516ec32d","collection":"contentId-3274178561","type":"file"}}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported