Deployment instructions - PuzzleServer/mainpuzzleserver GitHub Wiki

Note: Only admins have the right access to be able to perform this action. Please contact one of them if you need to perform a deployment.

Note: These instructions are intended for Visual Studio 2017

Not covered: How to deploy changes that include database updates

Go here to get to database update instructions. Update the database first before deploying the site.

1. Check that your current branch reflects what you intend to deploy

  • Make sure that the branch you currently have checked out is the one you intend to deploy
  • If you intend to deploy master, make sure your local branch is up-to-date with the remote branch
  • If you intend to deploy a different set of changes (not recommended) make sure that the correct changes appear in your local branch

2. Run the project / test for breaking changes

  • At the very least make sure the build works
  • Please also test key scenarios, especially those related to the changes you plan to deploy

3. Right-click on the ServerCore and select 'Publish'

image

4. Select the correct project (currently 'puzzlehunt - Web Deploy') and click 'Publish'

image

5. Enter the deployment password for the App Service and click 'OK'

These can be found in the Azure Portal by going to the puzzlehunt App Service -> Deployment Center -> Deployment Credentials. You can find the App Service by searching for "puzzlehunt" in the search bar in the top center of the portal. The username is auto-filled in visual studio and the password can be copied directly from that page. Finishing this step will deploy the website. image

6. Once the deployment has completed, check the live site to verify that changes are in place and that there are no major breaking issues

Congratulations - you've deployed a website! :D

Bonus: Troubleshooting

If you get errors while deploying, the most common fix is to restart the app service and then try the deployment again. The app service can be restarted by going to the puzzlehunt App Service in the Azure Portal and clicking the 'Restart' button at the top of the overview (the first page that loads). After the restart completes (usually very fast) then re-try the deployment from visual studio. image