kemko/nomad
1
0
Fork 0
mirror of https://github.com/kemko/nomad.git synced 2026-01-07 19:05:42 +03:00
Code Issues Packages Projects Releases Wiki Activity

Docs

Browse Source
This commit is contained in:
Alex Dadgar
2016-07-13 16:15:07 -06:00
parent c6968f18b7
commit 509bf07d4d
2 changed files with 62 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
command/fs.go
View File

@@ -55,6 +55,10 @@ FS Specific Options:
-stat
Show file stat information instead of displaying the file, or listing the directory.
-f
Causes the output to not stop when the end of the file is reached, but
rather to wait for additional output.
-tail
Show the files contents with offsets relative to the end of the file. If no
offset is given, -n is defaulted to 10.
@@ -65,11 +69,6 @@ FS Specific Options:
-c
Sets the tail location in number of bytes relative to the end of the file.
-f
Causes the output to not stop when the end of the file is reached, but
rather to wait for additional output.
`
return strings.TrimSpace(helpText)
}

72
website/source/docs/commands/fs.html.md.erb
View File

@@ -9,24 +9,58 @@ description: >
# Command: fs
The `fs` command allows a user to navigate an allocation directory on a Nomad
client. The following functionalities are available - `cat`, `ls` and `stat`
client. The following functionalities are available - `cat`, `tail`, `ls` and
`stat`.
`cat`: If the target path is a file, Nomad will cat the target path.
`ls`: If the target path is a directory, Nomad displays the name of a file and directories and their associated information.
`stat`: If the `-stat` flag is used, Nomad will Display information about a file.
* `cat`: If the target path is a file, Nomad will `cat` the file.
* `tail`: If the target path is a file and `-tail` flag is specified, Nomad will
`tail` the file.
* `ls`: If the target path is a directory, Nomad displays the name of a file and
directories and their associated information.
* `stat`: If the `-stat` flag is used, Nomad will display information about a
file.
## Usage
```
nomad fs <alloc-id> <path>
nomad fs -stat <alloc-id> <path>
nomad fs [options] <alloc-id> <path>
```
A valid allocation id is necessary unless `-job` is specified and the path is relative to the root of the allocation directory.
The path is optional and it defaults to `/` of the allocation directory
This command accepts a path and single allocation ID unless the `-job` flag is
specified, in which case an allocation is chosen for the given job. The path is
relative to the root of the allocation directory. The path is optional and it
defaults to `/` of the allocation directory
#
## General Options
<%= general_options_usage %>
## Fs Options
* `-H`: Machine friendly output.
* `-verbose`: Display verbose output.
* `-job`: Use a random allocation from the specified job, prefering a running
allocation.
* `-stat`: Show stat information instead of displaying the file, or listing the
directory.
* `-f`: Causes the output to not stop when the end of the file is reached, but
rather to wait for additional output.
* `-tail`: Show the files contents with offsets relative to the end of the file.
If no offset is given, -n is defaulted to 10.
* `-n`: Sets the tail location in best-efforted number of lines relative to the
end of the file.
* `-c`: Sets the tail location in number of bytes relative to the end of the file.
## Examples
```
$ nomad fs eb17e557
Mode Size Modified Time Name
drwxrwxr-x 4096 28 Jan 16 05:39 UTC alloc/
@@ -46,17 +80,27 @@ Mode Size Modified Time Name
$ nomad fs redis/local/redis.stdout
6710:C 27 Jan 22:04:03.794 # Warning: no config file specified, using the default config. In order to specify a config file use redis-server /path/to/redis.conf
6710:M 27 Jan 22:04:03.795 * Increased maximum number of open files to 10032 (it was originally set to 256).
foobar
baz
## Using Job-ID instead of Alloc-ID
$ nomad fs -tail -f -n 3 redis/local/redis.stdout
foobar
baz
bam
<blocking>
```
Passing `-job` into one of the `fs` commands will allow the `fs` command to randomly select an allocation ID from the specified job.
## Using Job ID instead of Allocation ID
Passing `-job` into one of the `fs` commands will allow the `fs` command to
randomly select an allocation ID from the specified job.
```
nomad fs -job <job-id> <path>
```
Nomad will prefer to select a running allocation ID for the job, but if no running allocations for the job are found, Nomad will use a dead allocation.
Nomad will prefer to select a running allocation ID for the job, but if no
running allocations for the job are found, Nomad will use a dead allocation.
This can be useful for debugging a job that has multiple allocations, and it's not really required to use a specific allocation ID.
This can be useful for debugging a job that has multiple allocations, and it's
not really required to use a specific allocation ID.