[WIP] Add chaincode job topic to doc

Signed-off-by: James Taylor <[email protected]>

Author: jt-nti

docs/concepts/chaincode-job.md

@@ -0,0 +1,33 @@
+# Chaincode job
+
+The k8s builder runs chaincode images using a long running Kubernetes job.
+
+
+## Labels
+
+Kubernetes objects created by the k8s builder have the following labels.
+
+| Key                              | Description                                                                                |
+| -------------------------------- | ------------------------------------------------------------------------------------------ |
+| app.kubernetes.io/name[^1]       | The name of the application: `hyperledger-fabric`                                          |
+| app.kubernetes.io/component[^1]  | The application component: `chaincode`                                                     |
+| app.kubernetes.io/created-by[^1] | The tool that created the object: `fabric-builder-k8s`                                     |
+| app.kubernetes.io/managed-by[^1] | The tool used to manage the application: `fabric-builder-k8s`                              |
+| fabric-builder-k8s-cclabel       | The chaincode label, e.g. `assetcc`                                                        |
+| fabric-builder-k8s-cchash        | Base32 encoded chaincode hash, e.g. `N6MMJOZJIFDXCMJO3XI2QE7O6WB56IJBYI24I6LXSLYUDJDNJNCQ` |
+
+[^1]:
+    Kubernetes defines [recommended labels](https://kubernetes.io/docs/concepts/overview/working-with-objects/common-labels/) to describe applications and instances of applications.
+
+## Annotations
+
+Kubernetes objects created by the k8s builder have the following annotations.
+
+| Key                              | Description                                                                                         |
+| -------------------------------- | --------------------------------------------------------------------------------------------------- |
+| fabric-builder-k8s-ccid          | The full chaincode ID, e.g. `mycc:a7ca45a7cc85f1d89c905b775920361ed089a364e12a9b6d55ba75c965ddd6a9` |
+| fabric-builder-k8s-mspid         | The membership service provider ID, e.g. `DigiBank`                                                 |
+| fabric-builder-k8s-peeraddress   | The peer address, e.g. `peer0.digibank.example.com`                                                 |
+| fabric-builder-k8s-peerid        | The peer ID, e.g. `peer0`                                                                           |
+
+

mkdocs.yml

@@ -101,6 +101,7 @@ nav:
     - Chaincode builder: concepts/chaincode-builder.md
     - Chaincode image: concepts/chaincode-image.md
     - Chaincode package: concepts/chaincode-package.md
+    - Chaincode job: concepts/chaincode-job.md
   - Configuring:
     - Configuration overview: configuring/overview.md
     - Kubernetes permissions: configuring/kubernetes-permissions.md