Merge pull request #134 from matyasselmeci/pr/custom-attributes.SOFTW…

…ARE-5324

Document advertising additional startd attributes (SOFTWARE-5324)

docs/resource-sharing/os-backfill-containers.md

@@ -213,6 +213,26 @@ the `--memory` argument tells Docker to kill the container if its total memory u
     Additionally, the processes that manage jobs also use some amount of memory.
     Therefore, it is important to give the container some extra room.
 
+
+### Advanced: Advertising additional pilot attributes
+
+You can put arbitrary additional attributes in the machine ads that the pilot advertises to the OSPool.
+These attributes will show up when users run `condor_status -l` against your pilot.
+This could be useful for advertising something about the way the pilot was provisioned.
+To do this, volume-mount a file containing `key=value` pairs to `/etc/osg/extra-attributes.cfg`.
+Keys must be valid classad attribute names and values must be valid classad expressions.
+Multi-line strings are not supported.
+A line starting with `#` will be treated as a comment.
+For example:
+
+```
+# The Kubernetes namespace this pod is running under
+KUBERNETES_NAMESPACE = "path-osgdev"
+# The deployment for this pilot
+KUBERNETES_DEPLOYMENT = "osgvo-docker-pilot-gpu"
+```
+
+
 Best Practices
 --------------