|
| 1 | +<!-- vale off --> |
1 | 2 | # NHS Notify Supplier API |
2 | 3 |
|
3 | 4 | [](https://github.com/NHSDigital/nhs-notify-supplier-api/actions/workflows/cicd-1-pull-request.yaml) |
@@ -75,9 +76,49 @@ New developers of the NHS Notify Supplier API should understand the below. |
75 | 76 |
|
76 | 77 | #### Prerequisites and Configuration |
77 | 78 |
|
78 | | -- Utilised the devcontainer, for pre reqs and configuration. |
79 | | -- You should open in a devcontainer or a Github workspaces. |
80 | | -- By default it will run `make config` when the container is first setup |
| 79 | +- Create the file `~/.aws/config` with the following contents: |
| 80 | + |
| 81 | + ```dsconfig |
| 82 | + [profile ] |
| 83 | + region = eu-west-2 |
| 84 | + output = json |
| 85 | +
|
| 86 | + [profile supplier-dev] |
| 87 | + sso_start_url = https://d-9c67018f89.awsapps.com/start#/ |
| 88 | + sso_region = eu-west-2 |
| 89 | + sso_account_id = 820178564574 |
| 90 | + sso_role_name = nhs-notify-bc-developer |
| 91 | + region = eu-west-2 |
| 92 | + output = json |
| 93 | +
|
| 94 | + [profile supplier-nonprod] |
| 95 | + sso_start_url = https://d-9c67018f89.awsapps.com/start#/ |
| 96 | + sso_region = eu-west-2 |
| 97 | + sso_account_id = 885964308133 |
| 98 | + sso_role_name = nhs-notify-bc-developer |
| 99 | + region = eu-west-2 |
| 100 | + output = json |
| 101 | + ``` |
| 102 | + |
| 103 | +- In your `~/.bashrc` or `~/.zshrc` add the export `export AWS_PROFILE=supplier-dev`, or whichever profile you need |
| 104 | +- In the project's root directory create an `.env` file based on the `.env.template` file and fill variables as needed. |
| 105 | +- Create the file `~/.npmrc` with the contents: |
| 106 | + |
| 107 | + ```dsconfig |
| 108 | + # Authenticate to GitHub Packages for github.com |
| 109 | + //npm.pkg.github.com/:_authToken=<Insert your Github PAT (Personal Access Token)> |
| 110 | +
|
| 111 | +
|
| 112 | + # Package is scoped under @org, set registry for that scope |
| 113 | + @nhsdigital:registry=https://npm.pkg.github.com |
| 114 | + ``` |
| 115 | + |
| 116 | +- Install `node` (to run `npm install` and build the project) |
| 117 | +- Install `aws cli` to be able to connect to AWS (needed for some tests) |
| 118 | +- If AWS CLI calls are blocked by a firewall (e.g. Zscaler), you need to add the custom certificates in the location `/scripts/devcontainer/custom-ca-certs` |
| 119 | +- Install `docker` or `Rancher` for containerisation |
| 120 | + - You should open in a devcontainer or a Github workspaces. (In VSCode -> Open Command Palet -> "Dev containers: rebuild without cache and reopen in container") |
| 121 | + - By default it will run `make config` when the container is first setup |
81 | 122 |
|
82 | 123 | ##### SDKs |
83 | 124 |
|
@@ -151,3 +192,5 @@ Import the files into postman |
151 | 192 | Select a target environment in postman |
152 | 193 | Run the collection |
153 | 194 | The collections must be kept in sync manually |
| 195 | + |
| 196 | +<!-- vale on --> |
0 commit comments