Skip to content

Commit b7546e6

Browse files
committed
Minor doc updates for clarity
1 parent 5a96168 commit b7546e6

1 file changed

Lines changed: 7 additions & 1 deletion

File tree

ECS_RUNNER_LIFETIME.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,12 +37,14 @@ All start paths converge on `EcsService.launchScorerTask(...)`.
3737
3. The handler skips the submission if the config is inactive, the challenge has no open phase, or no stored phase config matches the open challenge phase.
3838
4. For every matching phase config, the handler calls `EcsService.launchScorerTask(...)`.
3939

40-
This is the normal path for `EXAMPLE` and `PROVISIONAL` scoring during the Submission phase. If both phase configs map to the same open challenge phase, the API intentionally launches one runner per matching config.
40+
This is the normal path for `EXAMPLE` and `PROVISIONAL` scoring during the Submission phase. If both phase configs map to the same open challenge phase, the API intentionally launches one runner per matching config. This is to handle the case where we want example _and_ provisional tests to run during the submission phase in most cases.
4141

4242
### Validation submission scoring
4343

4444
`POST /v6/marathon-match/challenge/:challengeId/test-submission` uploads a validation submission through the configured Submission API and then launches one ECS runner for the requested `configType` (default `PROVISIONAL`). The response includes `submissionId`, `taskArn`, `taskId`, and usually `cloudWatchLogsConsoleUrl`.
4545

46+
We do this to support admins / copilots having the ability to test the scorer before the challenge launches.
47+
4648
### Manual latest-submission rerun
4749

4850
`POST /v6/marathon-match/challenge/:challengeId/rerun` finds the latest submission per member and launches scorer tasks for the phase config that matches the currently open challenge phase. Use this after changing tester configuration or when current latest submissions need to be recalculated.
@@ -59,6 +61,10 @@ SYSTEM scoring starts from review orchestration:
5961

6062
## What launch does
6163

64+
ECS Service:
65+
66+
https://github.com/topcoder-platform/marathon-match-api-v6/blob/955671e28e0d96fc871e2af060cf7d694a8a9475/src/shared/modules/global/ecs.service.ts#L85-L86
67+
6268
`EcsService.launchScorerTask(...)` performs these steps before and during `RunTask`:
6369

6470
1. Reads the configured ECS cluster, container name, network settings, API URL, review type, task definition family, and revision.

0 commit comments

Comments
 (0)