Skip to main content

Adoption

Code Repositories​

Clone/fork the following repositories:

The latter 2 produce Nuget packages, which if made public, could remove the need to clone their repositories.

Nugets​

HACT.Dtos and HousingRepairsOnline.Authentication produce Nuget packages which are consumed by other components.

Each repository contains setup instructions which can be followed to establish connectivity.

Infrastructure​

Azure is the supported Cloud platform.

Create the following resouces in Azure:

APIs​

  • Azure app service plan
    • Consider which service plan would best suit the needs. Premium V2 (P1v2: 1) is recommended
    • Use a region which is geographically close to the users/residents and the 3rd party data
  • Azure app service for each API
    • Create a 'staging' deployment slot
    • Each app service (and it's deployment slot) will have a publish profile which needs to be added to the repository secrets1
  • Cosmos DB
    • 2 databases - production and staging
    • Each with repair-requests collections
  • Blob storage account
    • Create 2 containers - production and staging

Frontend​

  • Create Azure Static Web App
    • A deployment token will need to be added to the repository secrets1

Integration​

Components​

Some of the Housing Repairs Online components will need to integrate to one another. This is by means of setting environment variables which is detailed within the documentation for each component.

3rd Party Systems​

Connectivity needs to be establish to each 3rd party system requiring integration.

Each component would require access to the system it is integrating with, i.e. Housing Management System API needs Housing Management System (i.e. Universal Housing) connectivity.

If data is stored on premise, a VPN or other datalink should be setup so that cloud deployed infrastructure has visibility of on premise infrastructure.

Alerting & Monitoring​

See Alerting & Monitoring for details.

Configuration​

Each component's configuration is outlined in their own specific documentation.

Please refer to this documentation to configure each component.

  1. When creating resource in Azure, if using Github integration, some of these secrets will be automatically added to the repository.↩