mirror of
https://github.com/kemko/nomad.git
synced 2026-01-04 09:25:46 +03:00
53b083b8c5
* Move commands from docs to its own root-level directory * temporarily use modified dev-portal branch with nomad ia changes * explicitly clone nomad ia exp branch * retrigger build, fixed dev-portal broken build * architecture, concepts and get started individual pages * fix get started section destinations * reference section * update repo comment in website-build.sh to show branch * docs nav file update capitalization * update capitalization to force deploy * remove nomad-vs-kubernetes dir; move content to what is nomad pg * job section * Nomad operations category, deploy section * operations category, govern section * operations - manage * operations/scale; concepts scheduling fix * networking * monitor * secure section * remote auth-methods folder and move up pages to sso; linkcheck * Fix install2deploy redirects * fix architecture redirects * Job section: Add missing section index pages * Add section index pages so breadcrumbs build correctly * concepts/index fix front matter indentation * move task driver plugin config to new deploy section * Finish adding full URL to tutorials links in nav * change SSO to Authentication in nav and file system * Docs NomadIA: Move tutorials into NomadIA branch (#26132) * Move governance and policy from tutorials to docs * Move tutorials content to job-declare section * run jobs section * stateful workloads * advanced job scheduling * deploy section * manage section * monitor section * secure/acl and secure/authorization * fix example that contains an unseal key in real format * remove images from sso-vault * secure/traffic * secure/workload-identities * vault-acl change unseal key and root token in command output sample * remove lines from sample output * fix front matter * move nomad pack tutorials to tools * search/replace /nomad/tutorials links * update acl overview with content from deleted architecture/acl * fix spelling mistake * linkcheck - fix broken links * fix link to Nomad variables tutorial * fix link to Prometheus tutorial * move who uses Nomad to use cases page; move spec/config shortcuts add dividers * Move Consul out of Integrations; move namespaces to govern * move integrations/vault to secure/vault; delete integrations * move ref arch to docs; rename Deploy Nomad back to Install Nomad * address feedback * linkcheck fixes * Fixed raw_exec redirect * add info from /nomad/tutorials/manage-jobs/jobs * update page content with newer tutorial * link updates for architecture sub-folders * Add redirects for removed section index pages. Fix links. * fix broken links from linkcheck * Revert to use dev-portal main branch instead of nomadIA branch * build workaround: add intro-nav-data.json with single entry * fix content-check error * add intro directory to get around Vercel build error * workound for emtpry directory * remove mdx from /intro/ to fix content-check and git snafu * Add intro index.mdx so Vercel build should work --------- Co-authored-by: Tu Nguyen <im2nguyen@gmail.com>
116 lines
3.2 KiB
Plaintext
116 lines
3.2 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: 'nomad plugin status command reference'
|
|
description: |
|
|
The `nomad plugin status` displays information and status for a specific plugin, plugins by type, or all plugins.
|
|
---
|
|
|
|
# `nomad plugin status` command reference
|
|
|
|
The `plugin status` command displays status information for [Container
|
|
Storage Interface (CSI)][csi] plugins.
|
|
|
|
## Usage
|
|
|
|
```plaintext
|
|
nomad plugin status [options] [plugin]
|
|
```
|
|
|
|
This command accepts an optional plugin ID or prefix as the sole argument. If there
|
|
is an exact match based on the provided plugin ID or prefix, then information about
|
|
the specific plugin is queried and displayed. Otherwise, a list of matching plugins
|
|
and information will be displayed.
|
|
|
|
If the ID is omitted, the command lists out all of the existing plugins and a few
|
|
of the most useful status fields for each.
|
|
|
|
If ACLs are enabled, this command requires a token with the `plugin:read`
|
|
capability.
|
|
|
|
## Options
|
|
|
|
- `-type`: Display only plugins of a particular type. Currently only
|
|
the `csi` type is supported, so this option can be omitted when
|
|
querying the status of CSI plugins.
|
|
|
|
- `-short`: Display short output. Used only when a single plugin is being queried.
|
|
Drops verbose plugin allocation data from the output.
|
|
|
|
- `-verbose`: Show full information. Allocation create and modify times are
|
|
shown in `yyyy/mm/dd hh:mm:ss` format.
|
|
|
|
## Examples
|
|
|
|
List of all plugins:
|
|
|
|
```shell-session
|
|
$ nomad plugin [-type csi] status
|
|
ID Provider Controllers Healthy / Expected Nodes Healthy / Expected
|
|
ebs-prod aws.ebs 1 / 1 1 / 1
|
|
```
|
|
|
|
Short view of a specific plugin:
|
|
|
|
```shell-session
|
|
$ nomad plugin [-type csi] status ebs-prod
|
|
ID = ebs-prod
|
|
Provider = aws.ebs
|
|
Version = 1.0.1
|
|
Controllers Healthy = 1
|
|
Controllers Expected = 1
|
|
Nodes Healthy = 1
|
|
Nodes Expected = 1
|
|
```
|
|
|
|
Full status information of a plugin with `-verbose` flag. Note that this example
|
|
shows a plugin that has all supported capabilities. Most plugins will support a
|
|
subset of these capabilities. Topology fields are also controlled by the plugin.
|
|
|
|
```shell-session
|
|
$ nomad plugin [-type csi] -verbose status ebs-prod
|
|
ID = ebs-prod
|
|
Provider = aws.ebs
|
|
Version = 1.0.1
|
|
Controllers Healthy = 1
|
|
Controllers Expected = 1
|
|
Nodes Healthy = 1
|
|
Nodes Expected = 1
|
|
|
|
Controller Capabilities
|
|
ATTACH_READONLY
|
|
CLONE_VOLUME
|
|
CONTROLLER_ATTACH_DETACH
|
|
CREATE_DELETE_SNAPSHOT
|
|
CREATE_DELETE_VOLUME
|
|
EXPAND_VOLUME
|
|
GET_CAPACITY
|
|
GET_VOLUME
|
|
LIST_SNAPSHOTS
|
|
LIST_VOLUMES
|
|
LIST_VOLUMES_PUBLISHED_NODES
|
|
VOLUME_CONDITION
|
|
|
|
Node Capabilities
|
|
EXPAND_VOLUME
|
|
GET_VOLUME_STATS
|
|
STAGE_UNSTAGE_VOLUME
|
|
VOLUME_ACCESSIBILITY_CONSTRAINTS
|
|
VOLUME_CONDITION
|
|
|
|
Accessible Topologies
|
|
Node ID Accessible Topology
|
|
95303afc topology.ebs.csi.aws.com/zone=us-east-1a
|
|
8bf94335 topology.ebs.csi.aws.com/zone=us-east-1b
|
|
|
|
Allocations
|
|
ID Node ID Task Group Version Desired Status Created Modified
|
|
0de05689 95303afc csi 0 run running 1m57s ago 1m19s ago
|
|
b206088c 8bf94335 csi 0 run running 1m56s ago 1m19s ago
|
|
```
|
|
|
|
## General options
|
|
|
|
@include 'general_options_no_namespace.mdx'
|
|
|
|
[csi]: https://github.com/container-storage-interface/spec
|