@@ -9,9 +9,9 @@ Compute sessions
9
9
Please consult the detailed usage in the help of each command.
10
10
(use ``-h `` or ``--help `` argument to display the manual)
11
11
12
- ----------------
12
+
13
13
Listing sessions
14
- ----------------
14
+ ~~~~~~~~~~~~~~~~
15
15
16
16
List the session owned by you with various status filters.
17
17
The most recently status-changed sessions are listed first.
@@ -96,9 +96,9 @@ Both commands offer options to specify which fields of sessions should be printe
96
96
97
97
.. _simple-execution :
98
98
99
- -----------------------
99
+
100
100
Running simple sessions
101
- -----------------------
101
+ ~~~~~~~~~~~~~~~~~~~~~~~
102
102
103
103
The following command spawns a Python session and executes
104
104
the code passed as ``-c `` argument immediately.
@@ -148,9 +148,9 @@ To watch what is happening behind the scene until the session starts,
148
148
try ``backend.ai events <sessionID> `` to receive the lifecycle events
149
149
such as its scheduling and preparation steps.
150
150
151
- ----------------------------------
151
+
152
152
Running sessions with accelerators
153
- ----------------------------------
153
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
154
154
155
155
Use one or more ``-r `` options to specify resource requirements when
156
156
using ``backend.ai run `` and ``backend.ai start `` commands.
@@ -165,9 +165,9 @@ memory to execute ``./mygpucode.py`` file inside it.
165
165
-r cpu=4 -r mem=8g -r cuda.shares=2 \
166
166
python-tensorflow:1.12-py36 ./mygpucode.py
167
167
168
- ----------------------------------
168
+
169
169
Terminating or cancelling sessions
170
- ----------------------------------
170
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
171
171
172
172
Without ``--rm `` option, your session remains alive for a configured
173
173
amount of idle timeout (default is 30 minutes).
@@ -290,9 +290,9 @@ Container Applications
290
290
Please consult the detailed usage in the help of each command
291
291
(use ``-h `` or ``--help `` argument to display the manual).
292
292
293
- ---------------------------------------------------------
293
+
294
294
Starting a session and connecting to its Jupyter Notebook
295
- ---------------------------------------------------------
295
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
296
296
297
297
The following command first spawns a Python session named "mysession"
298
298
without running any code immediately, and then executes a local proxy which
@@ -315,9 +315,9 @@ For the jupyter service, use your favorite web browser just like the
315
315
way you use Jupyter Notebooks.
316
316
To stop the ``app `` command, press ``Ctrl+C `` or send the ``SIGINT `` signal.
317
317
318
- -------------------------------------
318
+
319
319
Accessing sessions via a web terminal
320
- -------------------------------------
320
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
321
321
322
322
All Backend.AI sessions expose an intrinsic application named ``"ttyd" ``.
323
323
It is an web application that embeds xterm.js-based full-screen terminal
@@ -359,9 +359,9 @@ Options for ``app`` commands
359
359
* - ``-e, --env "ENVNAME=envvalue" ``
360
360
- Add additional environment variable when starting service.
361
361
362
- --------------------------------------
362
+
363
363
Accessing sessions via native SSH/SFTP
364
- --------------------------------------
364
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
365
365
366
366
Backend.AI offers direct access to compute sessions (containers) via SSH
367
367
and SFTP, by auto-generating host identity and user keypairs for all
@@ -520,9 +520,9 @@ Advanced Code Execution
520
520
Please consult the detailed usage in the help of each command
521
521
(use ``-h `` or ``--help `` argument to display the manual).
522
522
523
- --------------------------------------
523
+
524
524
Running concurrent experiment sessions
525
- --------------------------------------
525
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
526
526
527
527
In addition to single-shot code execution as described in
528
528
:ref: `simple-execution `, the ``run `` command offers concurrent execution of
@@ -588,9 +588,9 @@ values specified by each range.
588
588
Session Templates
589
589
-----------------
590
590
591
- --------------------------------------
591
+
592
592
Creating and starting session template
593
- --------------------------------------
593
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
594
594
595
595
Users may define commonly used set of session creation parameters as
596
596
reusable templates.
@@ -679,9 +679,10 @@ Other CRUD command examples are as follows:
679
679
680
680
* - ``update ``
681
681
- Update task template stored in Backend.AI Manager.
682
- -----------------------------
682
+
683
+
683
684
Full syntax for task template
684
- -----------------------------
685
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
685
686
686
687
.. code-block :: text
687
688
0 commit comments