You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@submarine.apache.org by pi...@apache.org on 2021/02/18 02:28:58 UTC

[submarine] branch master updated: SUBMARINE-733. Documentation for tensorboard

This is an automated email from the ASF dual-hosted git repository.

pingsutw pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/submarine.git


The following commit(s) were added to refs/heads/master by this push:
     new b0368d8  SUBMARINE-733. Documentation for tensorboard
b0368d8 is described below

commit b0368d8aac39a8529730c5f9d24b10a720f2cd66
Author: ByronHsu <by...@gmail.com>
AuthorDate: Thu Feb 18 10:16:10 2021 +0800

    SUBMARINE-733. Documentation for tensorboard
    
    ### What is this PR for?
    The instruction for tensorboard usage
    
    ### What type of PR is it?
    [Documentation]
    
    ### Todos
    * [ ] - Task
    
    ### What is the Jira issue?
    https://issues.apache.org/jira/browse/SUBMARINE-733
    
    ### How should this be tested?
    
    ### Screenshots (if appropriate)
    
    ### Questions:
    * Does the licenses files need update? No
    * Is there breaking changes for older versions? No
    * Does this needs documentation? No
    
    Author: ByronHsu <by...@gmail.com>
    
    Signed-off-by: Kevin <pi...@apache.org>
    
    Closes #507 from ByronHsu/TFBOARD_DOC and squashes the following commits:
    
    3f81245e [ByronHsu] move doc to website
    4bb30080 [ByronHsu] update readme
    000339a4 [ByronHsu] update readme
    f61e45d4 [ByronHsu] clarify env name
    fb72bf90 [ByronHsu] update readme
    084ee513 [ByronHsu] update readme
    61570705 [ByronHsu] update readme
    1e9bbe3e [ByronHsu] add tensorboard doc
---
 .../docs/assets/tensorboard-experiment-page.png    | Bin 0 -> 286667 bytes
 website/docs/assets/tensorboard-webpage.png        | Bin 0 -> 436355 bytes
 .../docs/userDocs/k8s/how-to-use-tensorboard.md    |  62 +++++++++++++++++++++
 3 files changed, 62 insertions(+)

diff --git a/website/docs/assets/tensorboard-experiment-page.png b/website/docs/assets/tensorboard-experiment-page.png
new file mode 100644
index 0000000..1eb0531
Binary files /dev/null and b/website/docs/assets/tensorboard-experiment-page.png differ
diff --git a/website/docs/assets/tensorboard-webpage.png b/website/docs/assets/tensorboard-webpage.png
new file mode 100644
index 0000000..8ac348c
Binary files /dev/null and b/website/docs/assets/tensorboard-webpage.png differ
diff --git a/website/docs/userDocs/k8s/how-to-use-tensorboard.md b/website/docs/userDocs/k8s/how-to-use-tensorboard.md
new file mode 100644
index 0000000..2931ee6
--- /dev/null
+++ b/website/docs/userDocs/k8s/how-to-use-tensorboard.md
@@ -0,0 +1,62 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# How to use tensorboard in submarine
+
+## Write to LogDirs by the environment variable
+
+### Environment variable
+
+- `SUBMARINE_TENSORBOARD_LOG_DIR`: Exist in every experiment container. You just need to direct your logs to `$(SUBMARINE_TENSORBOARD_LOG_DIR)` (**NOTICE: it is `()` not `{}`**), and you can inspect the process on the tensorboard webpage.
+
+### Example
+
+```
+{
+  "meta": {
+    "name": "tensorflow-tensorboard-dist-mnist",
+    "namespace": "default",
+    "framework": "TensorFlow",
+    "cmd": "python /var/tf_mnist/mnist_with_summaries.py --log_dir=$(SUBMARINE_TENSORBOARD_LOG_DIR) --learning_rate=0.01 --batch_size=20",
+    "envVars": {
+      "ENV_1": "ENV1"
+    }
+  },
+  "environment": {
+    "image": "apache/submarine:tf-mnist-with-summaries-1.0"
+  },
+  "spec": {
+    "Worker": {
+      "replicas": 1,
+      "resources": "cpu=1,memory=512M"
+    }
+  }
+}
+
+```
+
+## Connect to the tensorboard webpaage
+
+1. Open the experiment page in the workbench, and Click the `TensorBoard` button.
+
+![](../../assets/tensorboard-experiment-page.png)
+
+2. Inspect the process on tensorboard page.
+
+![](../../assets/tensorboard-webpage.png)


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@submarine.apache.org
For additional commands, e-mail: dev-help@submarine.apache.org