Skip to content

Latest commit

 

History

History
62 lines (49 loc) · 3.05 KB

README.md

File metadata and controls

62 lines (49 loc) · 3.05 KB
Raw

Provider Identity Portal (PIdP) API / Rebranded as OneHealthID Service

Visual Studio

Download install and sign-in

Entity Framework (open CLI )

dotnet tool install --gloabal dotnet-ef

Docker Desktop

Download install and sign-in

In the root of the project (CLI)

docker compose up

Install DBeaver

Download install -Open Dbeaver -> New Database connection->Select Postgres environment: POSTGRES_PASSWORD: postgres POSTGRES_USERNAME: postgres POSTGRES_DB: postgres ports: - "5433:5432" (https://github.com/bcgov/moh-pidp/blob/develop/docker-compose.yml)

Need to run the migrations generation command to generate the migrations in local environment(navigate to .backend\webapi)

dotnet ef migrations add MigrationName

Need to run the migrations to populate database with the PLR tables(navigate to .backend\services.plr-intake)

dotnet ef database update

Need to run the migrations to populate database with the tables(navigate to .backend\webapi)

dotnet ef database update

Inserting Test Data in local PLR tables.(navigate to .\backend\tools.plr-test-data)

dotnet build dotnet pack dotnet tool install plr-test-data --add-source .\nupkg
The tool can be invoked with "dotnet plr-test-data" in any backend folder. (https://github.com/bcgov/moh-pidp/tree/develop/backend/tools.plr-test-data)

Local Development Secrets

ASP.NET Core User Secrets

After acquiring the secrets.json file from the appropriate source, open a terminal in the the webapi folder and run type .\secrets.json | dotnet user-secrets set on Windows or cat ./secrets.json | dotnet user-secrets set on macOS / Linux to set the secrets for local development. After running the command, the original secrets.json file is no longer needed and should be deleted to avoid accidentally committing it to the repo.

On Windows, the secrets are automatically stored and retrieved from %APPDATA%\Microsoft\UserSecrets\<user_secrets_id>\secrets.json. On macOS / Linux, the location is ~/.microsoft/usersecrets/<user_secrets_id>/secrets.json. Running the application in Visual Studio Code should be OS agnostic. The local Docker container for the API, however, mounts the secrets file when brought up using docker-compose. Since they are stored at a different location for macOS / Linux, review the following lines in the main docker-compose.yml:

volumes:
  - ./backend/webapi/:/app
  - pidp-webapi-bin:/app/bin
  - pidp-webapi-obj:/app/obj
  - ${APPDATA}/Microsoft/UserSecrets/5c2dc965-00b4-4531-9ff0-9b37193ead9b:/root/.microsoft/usersecrets/5c2dc965-00b4-4531-9ff0-9b37193ead9b
  # Use the following instead if developing on Mac/Linux:
  # - ${HOME}/.microsoft/usersecrets/5c2dc965-00b4-4531-9ff0-9b37193ead9b:/root/.microsoft/usersecrets/5c2dc965-00b4-4531-9ff0-9b37193ead9b

The application's user secrets ID is set in the pidp.csproj file.