Skip to content

Commit 180a618

Browse files
committed
cleaning documentation
1 parent 63a9769 commit 180a618

1 file changed

Lines changed: 35 additions & 35 deletions

File tree

DOCS.md

Lines changed: 35 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
1-
# NetApp Neo CLI (`neoctl`) Documentation
1+
# NetApp Neo CLI (```neoctl```) Documentation
22

3-
`neoctl` is the command-line interface for managing NetApp Neo instances and software bundles. It simplifies the deployment, configuration, and lifecycle management of Neo Core and Neo UI components.
3+
```neoctl``` is the command-line interface for managing NetApp Neo instances and software bundles. It simplifies the deployment, configuration, and lifecycle management of Neo Core and Neo UI components.
44

55
## Prerequisites
66

7-
Before using `neoctl`, ensure your system meets the requirements:
7+
Before using ```neoctl```, ensure your system meets the requirements:
88
- **Operating System**: Linux (AMD64)
99
- **Container Runtime**: Docker or Podman
10-
- **Utilities**: `cifs-utils` (specifically `mount.cifs`)
10+
- **Utilities**: ```cifs-utils``` (specifically ```mount.cifs```)
1111

1212
Run the verify command to check your system:
1313
```bash
@@ -16,33 +16,33 @@ neoctl verify
1616

1717
## Global Concepts
1818

19-
- **Configuration**: Stored in `~/.neoctl/`.
20-
- `bundle.json`: Stores registry info and available versions.
21-
- `config.json`: (Internal use)
22-
- `instances.json`: Stores instance configurations.
19+
- **Configuration**: Stored in ```~/.neoctl/```.
20+
- ```bundle.json```: Stores registry info and available versions.
21+
- ```config.json```: (Internal use)
22+
- ```instances.json```: Stores instance configurations.
2323
- **Instances**: A named deployment of Neo (Core + UI + DB).
2424
- **Bundles**: The software images for Neo Core and Neo UI.
2525

2626
## Commands
2727

2828
### Global Flags
29-
- `--help`, `-h`: Show help for command.
29+
- ```--help```, ```-h```: Show help for command.
3030

31-
### `neoctl version`
31+
### ```neoctl version```
3232
Displays the current version of the CLI tool.
3333

3434
---
3535

3636
### Bundle Management
3737
Manage the software versions used for deploying instances.
3838

39-
#### `neoctl bundle get`
39+
#### ```neoctl bundle get```
4040
Fetches the latest version information from the configured container registries. This updates your local cache of available versions.
4141

42-
#### `neoctl bundle version`
42+
#### ```neoctl bundle version```
4343
Displays the currently configured versions and the cached "recent" versions for Neo Core and Neo UI.
4444

45-
#### `neoctl bundle configure`
45+
#### ```neoctl bundle configure```
4646
Sets the specific versions of Neo components to use for new instances.
4747

4848
**Usage:**
@@ -52,8 +52,8 @@ neoctl bundle configure reset
5252
```
5353

5454
**Flags:**
55-
- `--core <string>`: specific version tag for Neo Core.
56-
- `--ui <string>`: specific version tag for Neo UI.
55+
- ```--core <string>```: specific version tag for Neo Core.
56+
- ```--ui <string>```: specific version tag for Neo UI.
5757

5858
**Examples:**
5959
```bash
@@ -69,7 +69,7 @@ neoctl bundle configure reset
6969
### Instance Management
7070
Manage the lifecycle of Neo deployments.
7171

72-
#### `neoctl instance configure`
72+
#### ```neoctl instance configure```
7373
Creates or updates the configuration for a named instance.
7474

7575
**Usage:**
@@ -78,20 +78,20 @@ neoctl instance configure <name> [flags]
7878
```
7979

8080
**Flags:**
81-
- `--db`: Enable managed database (default true).
82-
- `--port-core <int>`: Port for Neo Core API (default 8081).
83-
- `--port-ui <int>`: Port for Neo Console UI (default 8080).
84-
- `--port-sql <int>`: Port for PostgreSQL (default 5432).
85-
- `--cpu <string>`: CPU limit (default "4").
86-
- `--memory <string>`: Memory limit (default "8G").
87-
- `--gpu`: Enable GPU support (requires NVIDIA runtime).
81+
- ```--db```: Enable managed database (default true).
82+
- ```--port-core <int>```: Port for Neo Core API (default 8081).
83+
- ```--port-ui <int>```: Port for Neo Console UI (default 8080).
84+
- ```--port-sql <int>```: Port for PostgreSQL (default 5432).
85+
- ```--cpu <string>```: CPU limit (default "4").
86+
- ```--memory <string>```: Memory limit (default "8G").
87+
- ```--gpu```: Enable GPU support (requires NVIDIA runtime).
8888

8989
**Example:**
9090
```bash
9191
neoctl instance configure my-neo --port-ui 8090
9292
```
9393

94-
#### `neoctl instance start`
94+
#### ```neoctl instance start```
9595
Starts a configured instance. Generates necessary environment and compose files.
9696

9797
**Usage:**
@@ -100,20 +100,20 @@ neoctl instance start <name> [flags]
100100
```
101101

102102
**Flags:**
103-
- `--all`: Start all configured instances.
103+
- ```--all```: Start all configured instances.
104104

105-
#### `neoctl instance stop`
106-
Stops a running instance.
105+
#### ```neoctl instance stop```
106+
Stops a running instance.
107107

108108
**Usage:**
109109
```bash
110110
neoctl instance stop <name> [flags]
111111
```
112112

113113
**Flags:**
114-
- `--all`: Stop all configured instances.
114+
- ```--all```: Stop all configured instances.
115115

116-
#### `neoctl instance delete`
116+
#### ```neoctl instance delete```
117117
Stops and removes an instance, deleting its configuration files.
118118

119119
**Usage:**
@@ -122,9 +122,9 @@ neoctl instance delete <name> [flags]
122122
```
123123

124124
**Flags:**
125-
- `--all`: Delete all configured instances.
125+
- ```--all```: Delete all configured instances.
126126

127-
#### `neoctl instance logs`
127+
#### ```neoctl instance logs```
128128
Fetches logs for an instance.
129129

130130
**Usage:**
@@ -133,11 +133,11 @@ neoctl instance logs <name> [flags]
133133
```
134134

135135
**Flags:**
136-
- `--archive`: Save logs for all services (neo, neoui, neodb) into a `.tar.gz` archive.
137-
- `--all`: Fetch logs for all instances.
136+
- ```--archive```: Save logs for all services (neo, neoui, neodb) into a `.tar.gz` archive.
137+
- ```--all```: Fetch logs for all instances.
138138

139-
#### `neoctl instance status`
139+
#### ```neoctl instance status```
140140
Lists all configured instances and their current running status (Running, Stopped, Degraded).
141141

142-
#### `neoctl instance show`
142+
#### ```neoctl instance show```
143143
Displays the raw JSON configuration of all instances.

0 commit comments

Comments
 (0)