Skip to content

Commit e7989d9

Browse files
committed
rename hyper to hyperctl
Signed-off-by: Lai Jiangshan <[email protected]>
1 parent 8aaaca3 commit e7989d9

26 files changed

+43
-43
lines changed

Diff for: get_started/install/build.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ And make sure you have `go` (>= 1.4) and `autotools`, develop files of
2020

2121
(If you want to build without Xen support, use configure option `--without-xen`.)
2222

23-
Then you can get the binaries `hyperd` daemon and `hyper` CLI tool.
23+
Then you can get the binaries `hyperd` daemon and `hyperctl` CLI tool.
2424

2525
#### Build Xen from source
2626

Diff for: get_started/install/mac.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ To install Hyper on Mac OS X, you need first to install VirtualBox 5.0, then dow
1414
The Hyper Mac package contains
1515

1616
- `hyperd` Daemon, which could be controled with `launchctl`
17-
- `hyper` cli tool with
17+
- `hyperctl` command line control tool with
1818
- An uninstall shell script, located under `/opt/hyper/bin/uninstall-hyper.sh`
1919

2020
> If you need to uninstall hyper and clean all existing images and containers, call the uninstall script with `--purge` flag.

Diff for: get_started/lifecycle.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -10,38 +10,38 @@ In Hyper, a Pod has two states:
1010

1111
A Pod can be launched either explicitly:
1212

13-
[root@user ~:]# hyper run -p podfile.json
13+
[root@user ~:]# hyperctl run -p podfile.json
1414

1515
Or, implicitly:
1616

17-
[root@user ~:]# hyper run -t ubuntu
17+
[root@user ~:]# hyperctl run -t ubuntu
1818

1919
In both cases, Pods and VMs are indivisible. Hyper will automatically provision a new VM instance to host the Pod, and the Pod will be `Running`.
2020

2121
However, you can also create a Pod, but without an underlying VM. In such case, the pod stays in `Created` state.
2222

23-
[root@user ~:]# hyper create -p podfile.json
23+
[root@user ~:]# hyperctl create -p podfile.json
2424

2525
There are two options to start the pod:
2626

27-
[root@user ~:]# hyper start pod_id
27+
[root@user ~:]# hyperctl start pod_id
2828

2929
The `START` command will trigger a VM provisioned, and allocate the new VM to the Pod. Alternatively, you can choose to `REPLACE` a running one:
3030

31-
[root@user ~:]# hyper replace -o old_pod_id -n new_pod_id
31+
[root@user ~:]# hyperctl replace -o old_pod_id -n new_pod_id
3232

3333
In this case, the VM instance will be de-associated from `old_pod_id` and re-assign to `new_pod_id`. Since the VM is already present, `REPLACE` is a faster option to launch a pod, than `RUN` and `START`.
3434

3535
> Note: `old_pod_id` must be running.
3636
3737
When you `STOP` a Pod, the underlying VM instance will be terminated:
3838

39-
[root@user ~:]# hyper stop pod_id
39+
[root@user ~:]# hyperctl stop pod_id
4040

4141
When stopped, the Pod will return to the `Created` state.
4242

4343
To permantly destroy a Pod, you need to `RM` it:
4444

45-
[root@user ~:]# hyper rm pod_id
45+
[root@user ~:]# hyperctl rm pod_id
4646

4747
Hyper will (stop if neccessary, then) remove the Pod definition and its storage.

Diff for: how_it_works.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,21 @@
22

33
Hyper has four components:
44

5-
- CLI: ***hyper***
5+
- CLI: ***hyperctl***
66
- Daemon: ***hyperd*** (with REST APIs)
77
- Guest Kernel: ***hyperkernel***
88
- Guest Init Service: ***hyperstart***
99

1010
On a physical Linux host:
1111

12-
[root@user ~:]# hyper pull nginx:latest
13-
[root@user ~:]# hyper run nginx:latest
12+
[root@user ~:]# hyperctl pull nginx:latest
13+
[root@user ~:]# hyperctl run nginx:latest
1414

1515
Upon ***RUN***, Hyper launches the Docker images with a new VM instance, instead of Linux containers:
1616

1717
[root@user ~:]# docker ps
1818
[root@user ~:]#
19-
[root@user ~:]# hyper list
19+
[root@user ~:]# hyperctl list
2020
......
2121
Done
2222

Diff for: pod/README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The key idea behind **Pod** is that in a microservice architecture usually invol
1212

1313
In Hyper, a pod consists of a colocated group of AppContainer images, deployed as a single unit in one Hyper instance.
1414

15-
[root@user ~:]# hyper run -p nginx rails logstash cronjob
15+
[root@user ~:]# hyperctl run -p nginx rails logstash cronjob
1616

1717
Inside of the instance, multiple applications from different images share the namespaces: ***`PID`***, ***`Network`***, ***`IPC`***, ***`UTS`***, ***`User`***. Pod helps to provide a familiar view of a tranditional OS to applications, rather than the philosophy of "*one process per container*":
1818

Diff for: reference/attach.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Attach a specified container in a Pod to TTY
44

55
Usage:
6-
hyper attach CONTAINER
6+
hyperctl attach CONTAINER
77

88
Help Options:
99
-h, --help Show this help message

Diff for: reference/build.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Build a new image from the source code at PATH
44

55
```
66
Usage:
7-
hyper build [OPTIONS] PATH
7+
hyperctl build [OPTIONS] PATH
88
99
Application Options:
1010
-t, --tag="" Repository name (and optionally a tag) to be applied to the resulting image in case of success
@@ -14,5 +14,5 @@ Help Options:
1414
-h, --help Show this help message
1515
1616
Example:
17-
hyper build -t test /dockerfile/path/
17+
hyperctl build -t test /dockerfile/path/
1818
```

Diff for: reference/cli.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
```
44
Usage:
55
6-
hyper [OPTIONS] COMMAND [ARGS...]
6+
hyperctl [OPTIONS] COMMAND [ARGS...]
77
88
Command:
99
@@ -30,5 +30,5 @@ Help Options:
3030
3131
-h, --help Show this help message
3232
33-
Run 'hyper COMMAND --help' for more information on a command.
33+
Run 'hyperctl COMMAND --help' for more information on a command.
3434
```

Diff for: reference/commit.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Create a new image from a container's changes
66

77
```
88
Usage:
9-
hyper commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]
9+
hyperctl commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]
1010
1111
Application Options:
1212
-a, --author="" Author (e.g., "Hello World <[email protected]>")

Diff for: reference/containers.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
- `name`: the identifier of a container; a random id will be given if absent
44

5-
- `image`: in the form `[registry]/image[:tag]`; hyper will automatically pull the image if missing
5+
- `image`: in the form `[registry]/image[:tag]`; hyperctl will automatically pull the image if missing
66

77
- `command`: the shell command to run when the container starts
88

Diff for: reference/create.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Define a Pod and allocate storage, but without starting it. The Pod will stay in `Created` state.
44

55
Usage:
6-
hyper create POD_FILE
6+
hyperctl create POD_FILE
77

88
Help Options:
99
-h, --help Show this help message

Diff for: reference/exec.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@
33
Run a command in a container or a Pod, and attach the current terminal to the command stdio.
44

55
Usage:
6-
hyper exec POD_ID:CONTAINER_NAME COMMAND [ARGS...]
6+
hyperctl exec POD_ID:CONTAINER_NAME COMMAND [ARGS...]
77

88
Help Options:
99
-h, --help Show this help message
1010

1111
Example:
12-
hyper exec pod-3uhg23po:nginx echo "Hello World"
12+
hyperctl exec pod-3uhg23po:nginx echo "Hello World"

Diff for: reference/images.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ List images
44

55
```
66
Usage:
7-
hyper images [OPTIONS] [REPOSITORY]
7+
hyperctl images [OPTIONS] [REPOSITORY]
88
99
Application Options:
1010
-a, --all Show all images (by default filter out the intermediate image layers) (false)

Diff for: reference/info.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Display system-wide information
44

55
Usage:
6-
hyper info
6+
hyperctl info
77

88
Help Options:
99
-h, --help Show this help message

Diff for: reference/kill.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Kill an idle running VM
44

55
Usage:
6-
hyper kill VM_ID
6+
hyperctl kill VM_ID
77

88
Help Options:
99
-h, --help Show this help message

Diff for: reference/list.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Display the Pod, VM or container information
44

55
Usage:
6-
hyper list [OPTIONS] [pod|vm|container]
6+
hyperctl list [OPTIONS] [pod|vm|container]
77

88
Help Options:
99
-h, --help Show this help message

Diff for: reference/login.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ specified "https://index.docker.io/v1/" is the default.
55

66
```
77
Usage:
8-
hyper login [SERVER]
8+
hyperctl login [SERVER]
99
1010
Application Options:
1111
-e, --email="" Email

Diff for: reference/logout.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Log out from a Docker registry, if no server is specified "https://index.docker.
44

55
```
66
Usage:
7-
hyper logout [SERVER]
7+
hyperctl logout [SERVER]
88
99
Help Options:
1010
-h, --help Show this help message

Diff for: reference/pull.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Pull an image from a Docker registry server
44

55
```
66
Usage:
7-
hyper pull IMAGE
7+
hyperctl pull IMAGE
88
99
Help Options:
1010
-h, --help Show this help message

Diff for: reference/push.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Push an image to a Docker registry server
44

55
```
66
Usage:
7-
hyper push NAME[:TAG]
7+
hyperctl push NAME[:TAG]
88
99
Help Options:
1010
-h, --help Show this help message

Diff for: reference/replace.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Deallocate the VM instance from a `Running` Pod A and re-assign to a `Created` P
55
(This command is only avaiable on Linux version)
66

77
Usage:
8-
hyper replace --oldpod POD_ID --newpod POD_ID [--file POD_FILE]
8+
hyperctl replace --oldpod POD_ID --newpod POD_ID [--file POD_FILE]
99

1010
Application Options:
1111
-o, --oldpod="" The Pod that will be replaced, must be in 'running' status

Diff for: reference/rm.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Remove a Pod permantly, cleanup its disk storage.
44

55

66
Usage:
7-
hyper rm POD_ID [POD_ID...]
7+
hyperctl rm POD_ID [POD_ID...]
88

99
Help Options:
1010
-h, --help Show this help message

Diff for: reference/rmi.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Remove one or more images
44

55
```
66
Usage:
7-
hyper rmi [OPTIONS] IMAGE [IMAGE...]
7+
hyperctl rmi [OPTIONS] IMAGE [IMAGE...]
88
99
Application Options:
1010
--no-prune Do not delete untagged parents

Diff for: reference/run.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Launch one or multiple Docker images as a Pod, with a new VM instance
44

55
Usage:
6-
hyper run [OPTIONS] IMAGE [COMMAND] [ARG...]
6+
hyperctl run [OPTIONS] IMAGE [COMMAND] [ARG...]
77

88
Create a pod, and launch a new VM to run the pod
99

@@ -30,10 +30,10 @@ Launch one or multiple Docker images as a Pod, with a new VM instance
3030
-h, --help Show this help message
3131

3232
Example:
33-
hyper run -t ubuntu
34-
hyper run -t ubuntu:latest
35-
hyper run -t ubuntu /bin/bash
36-
hyper run -d nginx
37-
hyper run -p mypod.json
33+
hyperctl run -t ubuntu
34+
hyperctl run -t ubuntu:latest
35+
hyperctl run -t ubuntu /bin/bash
36+
hyperctl run -d nginx
37+
hyperctl run -p mypod.json
3838

3939

Diff for: reference/start.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Launch a `Created` Pod, with a new VM instance
44

55
Usage:
6-
hyper start POD_ID
6+
hyperctl start POD_ID
77

88
Help Options:
99
-h, --help Show this help message

Diff for: reference/stop.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Stop a `Running` Pod, which will return to `Created` state
44

55
Usage:
6-
hyper stop POD_ID
6+
hyperctl stop POD_ID
77

88
Help Options:
99
-h, --help Show this help message

0 commit comments

Comments
 (0)