OLD | NEW |
---|---|
1 # Magic Values | 1 # Magic Values |
2 | 2 |
3 Describes magic values on the swarming server | 3 Describes magic values on the swarming server |
4 | 4 |
5 ## Introduction | 5 ## Introduction |
6 | 6 |
7 There are a few "magic" values in the isolate and swarming server. Also some | 7 There are a few "magic" values in the isolate and swarming server. Also some |
8 dimensions and state values have special meaning. | 8 dimensions and state values have special meaning. |
9 | 9 |
10 | 10 |
(...skipping 15 matching lines...) Expand all Loading... | |
26 statement after the task. | 26 statement after the task. |
27 | 27 |
28 | 28 |
29 ## Swarming | 29 ## Swarming |
30 | 30 |
31 ### Task execution environment | 31 ### Task execution environment |
32 | 32 |
33 When a Swarming bot is running a task, the following environment variables are | 33 When a Swarming bot is running a task, the following environment variables are |
34 always set: | 34 always set: |
35 | 35 |
36 - `SWARMING_HEADLESS=1` is always set. | 36 - `SWARMING_HEADLESS=1` is always set. |
M-A Ruel
2016/06/07 22:41:19
We should probably get rid of it one day but I thi
| |
37 - `SWARMING_BOT_ID` is set to the bot id. | 37 - `SWARMING_BOT_ID` is set to the bot id. |
38 - `SWARMING_TASK_ID` is set to the task id. | |
M-A Ruel
2016/06/07 22:41:19
Thanks! I had totally forgot to document it.
| |
39 - `SWARMING_AUTH_PARAMS` is path to a file with task authentication tokens. | |
38 | 40 |
39 | 41 |
40 ### dimensions | 42 ### dimensions |
41 | 43 |
42 - `id`: must be a single value in the list, which also must be unique. It's | 44 - `id`: must be a single value in the list, which also must be unique. It's |
43 what uniquely identify the bot. | 45 what uniquely identify the bot. |
44 - `quarantined`: if present, it specifies the bot self-quarantined, as it | 46 - `quarantined`: if present, it specifies the bot self-quarantined, as it |
45 found out it needs manual sysadmin assistance before being able to accept | 47 found out it needs manual sysadmin assistance before being able to accept |
46 any task. An example is that it doesn't enough free disk space. | 48 any task. An example is that it doesn't enough free disk space. |
47 | 49 |
48 | 50 |
49 ### state | 51 ### state |
50 | 52 |
51 - `cost_usd_hour`: reports the base cost of this bot in $USD/hour. | 53 - `cost_usd_hour`: reports the base cost of this bot in $USD/hour. |
52 - `lease_expiration_ts`: when set to an integer or floating point value, | 54 - `lease_expiration_ts`: when set to an integer or floating point value, |
53 informs the server of the time (in UTC seconds since epoch) that the bot | 55 informs the server of the time (in UTC seconds since epoch) that the bot |
54 will disconnect from the server. The server will not allow the bot to | 56 will disconnect from the server. The server will not allow the bot to |
55 reap any tasks projected to end after the bot disconnects. | 57 reap any tasks projected to end after the bot disconnects. |
56 - `periodic_reboot_secs`: when set to a integer, instructs the server to send | 58 - `periodic_reboot_secs`: when set to a integer, instructs the server to send |
57 a reboot command after this period. The actual period is fuzzed with a 10% | 59 a reboot command after this period. The actual period is fuzzed with a 10% |
58 delta. | 60 delta. |
59 - `quarantined`: has the same meaning than in `dimensions`. It's also | 61 - `quarantined`: has the same meaning than in `dimensions`. It's also |
60 supported as a state. | 62 supported as a state. |
OLD | NEW |