Chromium Code Reviews Chromium Code Reviews
Issue 2987333002:
Refactor all gRPC proxy code into a single class. (Closed)
| 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 26 matching lines...) Expand all Loading... | |
| 37 When a Swarming bot is running a task, the following environment variables are | 37 When a Swarming bot is running a task, the following environment variables are |
| 38 always set: | 38 always set: |
| 39 | 39 |
| 40 - `SWARMING_HEADLESS=1` is always set. | 40 - `SWARMING_HEADLESS=1` is always set. |
| 41 - `SWARMING_BOT_ID` is set to the bot id. | 41 - `SWARMING_BOT_ID` is set to the bot id. |
| 42 - `SWARMING_TASK_ID` is set to the task id. | 42 - `SWARMING_TASK_ID` is set to the task id. |
| 43 | 43 |
| 44 The following environment variables may be set to alter bot behavior: | 44 The following environment variables may be set to alter bot behavior: |
| 45 | 45 |
| 46 - `SWARMING_EXTERNAL_BOT_SETUP=1` disables bot_config.setup_bot hook. | 46 - `SWARMING_EXTERNAL_BOT_SETUP=1` disables bot_config.setup_bot hook. |
| 47 - `SWARMING_GRPC_PROXY=<url>` and `ISOLATED_GRPC_PROXY=<url>` override the | |
| 48 same value in the bot config. | |
| 49 - `GRPC_PROXY_TLS_ROOTS=<file>` and points to a .crt file containing | |
| 50 certificate authorities. `GRPC_PROXY_TLS_OVERRIDE=<name>` specifies the name | |
| 51 of the server in the certificate. These are useful for testing a gRPC proxy | |
| 52 running on localhost but with TLS enabled. Unlike the `*_GRPC_PROXY` env | |
| 53 vars, these are shared between Swarming and Isolated since they're only used | |
| 54 in the limited case when you need to override TLS. See | |
| 55 /client/utils/grpc_proxy.py for more information. | |
|
M-A Ruel
2017/08/04 02:05:37
you can link directly with:
[/client/utils/grpc_p
aludwin
2017/08/04 14:53:10
Done.
| |
| 47 | 56 |
| 48 | 57 |
| 49 ### dimensions | 58 ### dimensions |
| 50 | 59 |
| 51 - `id`: must be a single value in the list, which also must be unique. It's | 60 - `id`: must be a single value in the list, which also must be unique. It's |
| 52 what uniquely identify the bot. | 61 what uniquely identify the bot. |
| 53 - `quarantined`: if present, it specifies the bot self-quarantined, as it | 62 - `quarantined`: if present, it specifies the bot self-quarantined, as it |
| 54 found out it needs manual sysadmin assistance before being able to accept | 63 found out it needs manual sysadmin assistance before being able to accept |
| 55 any task. An example is that it doesn't enough free disk space. | 64 any task. An example is that it doesn't enough free disk space. |
| 56 | 65 |
| (...skipping 15 matching lines...) Expand all Loading... | |
| 72 handshake. The server will ask the bot to restart if this configuration | 81 handshake. The server will ask the bot to restart if this configuration |
| 73 changes. | 82 changes. |
| 74 | 83 |
| 75 ### tags | 84 ### tags |
| 76 | 85 |
| 77 - `source_revision`: if present, it specifies the SCM revision related to the | 86 - `source_revision`: if present, it specifies the SCM revision related to the |
| 78 task. This allows the UI to link to the relevant revision. | 87 task. This allows the UI to link to the relevant revision. |
| 79 - `source_repo`: if present, it is a url to the hosted SCM related to the | 88 - `source_repo`: if present, it is a url to the hosted SCM related to the |
| 80 task, with a %s where the revision should be placed. This allows the UI | 89 task, with a %s where the revision should be placed. This allows the UI |
| 81 to link to the relevant revision. | 90 to link to the relevant revision. |
| OLD | NEW |
