1 # Copyright (C) The Arvados Authors. All rights reserved.
3 # SPDX-License-Identifier: AGPL-3.0
5 # Azure configuration for Arvados Node Manager.
6 # All times are in seconds unless specified otherwise.
9 # The management server responds to http://addr:port/status.json with
10 # a snapshot of internal state.
12 # Management server listening address (default 127.0.0.1)
15 # Management server port number (default -1, server is disabled)
21 # The dispatcher can customize the start and stop procedure for
22 # cloud nodes. For example, the SLURM dispatcher drains nodes
23 # through SLURM before shutting them down.
26 # Node Manager will ensure that there are at least this many nodes running at
27 # all times. If node manager needs to start new idle nodes for the purpose of
28 # satisfying min_nodes, it will use the cheapest node type. However, depending
29 # on usage patterns, it may also satisfy min_nodes by keeping alive some
30 # more-expensive nodes
33 # Node Manager will not start any compute nodes when at least this
37 # Upper limit on rate of spending (in $/hr), will not boot additional nodes
38 # if total price of already running nodes meets or exceeds this threshold.
39 # default 0 means no limit.
42 # Poll Azure nodes and Arvados for new information every N seconds.
45 # Polls have exponential backoff when services fail to respond.
46 # This is the longest time to wait between polls.
49 # If Node Manager can't succesfully poll a service for this long,
50 # it will never start or stop compute nodes, on the assumption that its
51 # information is too outdated.
54 # If Node Manager boots a cloud node, and it does not pair with an Arvados
55 # node before this long, assume that there was a cloud bootstrap failure and
56 # shut it down. Note that normal shutdown windows apply (see the Cloud
57 # section), so this should be shorter than the first shutdown window value.
60 # "Node stale time" affects two related behaviors.
61 # 1. If a compute node has been running for at least this long, but it
62 # isn't paired with an Arvados node, do not shut it down, but leave it alone.
63 # This prevents the node manager from shutting down a node that might
64 # actually be doing work, but is having temporary trouble contacting the
66 # 2. When the Node Manager starts a new compute node, it will try to reuse
67 # an Arvados node that hasn't been updated for this long.
68 node_stale_after = 14400
70 # Scaling factor to be applied to nodes' available RAM size. Usually there's a
71 # variable discrepancy between the advertised RAM value on cloud nodes and the
72 # actual amount available.
73 # If not set, this value will be set to 0.95
74 node_mem_scaling = 0.95
76 # File path for Certificate Authorities
77 certs_file = /etc/ssl/certs/ca-certificates.crt
81 #file = node-manager.log
83 # Log level for most Node Manager messages.
84 # Choose one of DEBUG, INFO, WARNING, ERROR, or CRITICAL.
85 # WARNING lets you know when polling a service fails.
86 # INFO additionally lets you know when a compute node is started or stopped.
89 # You can also set different log levels for specific libraries.
90 # Pykka is the Node Manager's actor library.
91 # Setting this to DEBUG will display tracebacks for uncaught
92 # exceptions in the actors, but it's also very chatty.
95 # Setting apiclient to INFO will log the URL of every Arvados API request.
104 # Accept an untrusted SSL certificate from the API server?
109 driver_class = {driver_class}
111 # Shutdown windows define periods of time when a node may and may not be shut
112 # down. These are windows in full minutes, separated by commas. Counting from
113 # the time the node is booted, the node WILL NOT shut down for N1 minutes; then
114 # it MAY shut down for N2 minutes; then it WILL NOT shut down for N3 minutes;
115 # and so on. For example, "20, 999999" means the node may shut down between
116 # the 20th and 999999th minutes of uptime.
117 # Azure bills by the minute, so it makes sense to agressively shut down idle
118 # nodes. Specify at least two windows. You can add as many as you need beyond
120 shutdown_windows = 0.05, 999999
123 # Use "azure account list" with the azure CLI to get these values.
124 tenant_id = 00000000-0000-0000-0000-000000000000
125 subscription_id = 00000000-0000-0000-0000-000000000000
127 # The following directions are based on
128 # https://azure.microsoft.com/en-us/documentation/articles/resource-group-authenticate-service-principal/
130 # azure config mode arm
131 # azure ad app create --name "<Your Application Display Name>" --home-page "<https://YourApplicationHomePage>" --identifier-uris "<https://YouApplicationUri>" --password <Your_Password>
132 # azure ad sp create "<Application_Id>"
133 # azure role assignment create --objectId "<Object_Id>" -o Owner -c /subscriptions/<subscriptionId>/
135 # Use <Application_Id> for "key" and the <Your_Password> for "secret"
137 key = 00000000-0000-0000-0000-000000000000
143 # The resource group in which the compute node virtual machines will be created
145 ex_resource_group = ArvadosResourceGroup
148 # The image id, in the form "Publisher:Offer:SKU:Version"
149 image = Canonical:UbuntuServer:14.04.3-LTS:14.04.201508050
151 # Path to a local ssh key file that will be used to provision new nodes.
154 # The account name for the admin user that will be provisioned on new nodes.
155 ex_user_name = arvadosuser
157 # The Azure storage account that will be used to store the node OS disk images.
158 ex_storage_account = arvadosstorage
160 # The virtual network the VMs will be associated with.
161 ex_network = ArvadosNetwork
163 # Optional subnet of the virtual network.
167 tag_arvados-class = dynamic-compute
170 # the API server to ping
173 # You can define any number of Size sections to list Azure sizes you're willing
174 # to use. The Node Manager should boot the cheapest size(s) that can run jobs
175 # in the queue. You must also provide price per hour as the Azure driver
176 # compute currently does not report prices.
178 # See https://azure.microsoft.com/en-us/pricing/details/virtual-machines/
179 # for a list of known machine types that may be used as a Size parameter.
181 # Each size section MUST define the number of cores are available in this
182 # size class (since libcloud does not provide any consistent API for exposing
184 # You may also want to define the amount of scratch space (expressed
185 # in GB) for Crunch jobs. You can also override Microsoft's provided
186 # data fields by setting them here.