Add additional deployment examples to the documentation

[martinpeck]

The following topics should be added to the documentation:

• Docs: How AzureTRE might be Deployed with Custom Templates
• Docs: How AzureTRE might be Deployed across Multiple Environments - Initially UAT and Production, sharing management registry so bundles are only built once. On manual approval deploy to production.
• Deployment Repo: Samples of the above

These should be added to a new section within the documentation, named Resources under which we can then add FAQs, whitepapers, examples, case studies, and other non-reference docs.

• Docs: Create new Resources section for Documentation

[marrobi]

Thanks for creating this.

Can we also have maybe how the make commands are used in a CI/CD pipeline? Might be we have ADO and/or GItHub actions examples, but feel this is something that needs better docs. Thoughts?

[martinpeck]

how the make commands are used in a CI/CD pipeline

What do you mean? I'm keen not to document the GitHub action workflows (the workflows document themselves).
It might be useful to have an illustrated example of building an AzDO pipeline, and using the make commands.

[marrobi]

Agree, diagram of stages and make commands.

[marrobi]

Samples or Examples might be better than Resources?

[tamirkamara]

I think the docs already specify how to add custom templates and include them in the CICD:
https://microsoft.github.io/AzureTRE/using-tre/templates/
https://microsoft.github.io/AzureTRE/tre-admins/setup-instructions/cicd-deplyment/

Marking that item as done.

[marrobi]

@tamirkamara people are struggling to get the party correct for custom templates when using the deployment repository. I don't think the examples in the CI/CD doc are quite right.

Will find an example Monday.

[marrobi]

@damoodamoo to share work from in progress engagement so no need for new content to be created by anybody else.

[martinpeck]

Where do you want this to be added @marrobi? i.e. which section of the docs?

[marrobi]

Maybe a Deployment section in:

And the workflows in the AzureTRE-Deployment repository?

[tamirkamara]

What workflows? I thought this is more like a sample...
Need to remember that all workflows are automatically enabled when creating the repo (unless defined differently by the org). Plus GitHub Actions doesn't really support the notion of environment progression. Together this might present a real problem so we need to carefully consider this.