Merge pull request #4349 from nulib/deploy/staging

Deploy vX.X.X to production

Author: mbklein

.github/workflows/test.yml

@@ -21,7 +21,7 @@ jobs:
           otp-version: "26"
           elixir-version: "1.15.4"
       - name: Cache Elixir dependencies
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             app/deps
@@ -30,7 +30,7 @@ jobs:
             ${{ runner.os }}-hex-v6-${{ hashFiles('app/mix.lock') }}
             ${{ runner.os }}-hex-v6-
       - name: Cache Elixir build
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             app/_build
@@ -40,7 +40,7 @@ jobs:
             ${{ runner.os }}-hex-v6-${{ hashFiles('app/mix.lock') }}
             ${{ runner.os }}-hex-v6-
       - name: Cache JS dependencies
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             app/assets/node_modules
@@ -75,7 +75,7 @@ jobs:
         with:
           node-version-file: ./.tool-versions
       - name: Cache Elixir dependencies
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             app/deps
@@ -85,7 +85,7 @@ jobs:
             ${{ runner.os }}-hex-v6-${{ hashFiles('app/mix.lock') }}
             ${{ runner.os }}-hex-v6-
       - name: Cache Elixir build
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             app/_build
@@ -95,7 +95,7 @@ jobs:
             ${{ runner.os }}-hex-v6-${{ hashFiles('app/mix.lock') }}
             ${{ runner.os }}-hex-v6-
       - name: Cache JS dependencies
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             app/assets/node_modules
@@ -192,7 +192,7 @@ jobs:
           perl Makefile.PL && \
           sudo make install
       - name: Cache Elixir dependencies
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             app/deps
@@ -201,7 +201,7 @@ jobs:
             ${{ runner.os }}-hex-v6-${{ hashFiles('app/mix.lock') }}
             ${{ runner.os }}-hex-v6-
       - name: Cache Elixir build
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             app/_build
@@ -211,7 +211,7 @@ jobs:
             ${{ runner.os }}-hex-v6-${{ hashFiles('app/mix.lock') }}
             ${{ runner.os }}-hex-v6-
       - name: Cache JS dependencies
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: |
             app/assets/node_modules

README.md

@@ -56,7 +56,35 @@ If you would like to interact directly with the database
 
 ### Run the Elixir test suite
 
-- run `mix test`
+#### Start Test Services
+
+In one terminal:
+```
+cd infrastructure/localstack
+docker compose up
+```
+
+#### Provision Test Environment
+
+Watch the logs until the services seem to stabilize. Then, in another terminal:
+```
+cd infrastructure/localstack
+terraform init
+terraform apply -auto-approve \
+  -var-file test.tfvars \
+  -var localstack_endpoint=https://localhost.localstack.cloud:4566
+```
+
+You will probably see `Warning: AWS account ID not found for provider`, but this can be safely ignored.
+
+#### Run Tests
+
+```
+cd app
+mix test [test args...]
+```
+
+**Note:** `mix test` can be run repeatedly without re-provisioning as long as the Docker services are running. If you stop the services, you will need to run Terraform again.
 
 ### GraphQL API