Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add docs about lxcfs feature #1461

Merged
merged 7 commits into from
Jun 4, 2018
Merged

docs: add docs about lxcfs feature #1461

Changes from 6 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
3655440
Merge pull request #1 from alibaba/master
fanux Jun 4, 2018
9f516a7
add
fanux Jun 4, 2018
f0c3620
add
fanux Jun 4, 2018
0ec08f1
docs: add docs about feature lxcfs
fanux Jun 4, 2018
357dde8
docs: add docs about feature lxcfs
fanux Jun 4, 2018
f13e662
docs: add docs about feature lxcfs
fanux Jun 4, 2018
f2d3d7a
docs: add docs about feature lxcfs, move to Prerequisites
fanux Jun 4, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions docs/features/pouch_with_lxcfs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,29 @@ Container solutions provide a general way for users to limit resource usage of r

For example, if we create a general container with limiting 200 MB memory on host of 2 GB memory in total, we can find that resource upper limit is incorrect via command `free`, and it shows all memory size of the host:

Make sure your lxcfs service is running:
Copy link
Collaborator

@allencloud allencloud Jun 4, 2018 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for your contribution very much. I do think we need this part very much. While I am still wondering if here is the best place to locate the prerequisites of the lxcfs functionablity.

How about adding a third leval title of Prerequisites in the second level of Get Started? @fanux


```
$ systemctl start lxcfs
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should add some restriction for this part code shell command, since I think systemctl can be used on some constraint os distributions, not all.

Otherwise, doc readers may feel that for all the os distributions, they could use these script command. WDYT? @fanux

$ ps -aux|grep lxcfs
root 1465765 0.0 0.0 95368 1844 ? Ssl 11:55 0:00 /usr/bin/lxcfs /var/lib/lxcfs/
root 1465971 0.0 0.0 112736 2408 pts/0 S+ 11:55 0:00 grep --color=auto lxcfs
```

Enable pouchd lxcfs (with --enable-lxcfs flag):

```
$ cat /usr/lib/systemd/system/pouch.service
[Unit]
Description=pouch

[Service]
ExecStart=/usr/local/bin/pouchd --enable-lxcfs
...

$ systemctl daemon-reload && systemctl restart pouch
```

``` shell
$ pouch run -m 200m registry.hub.docker.com/library/ubuntu:16.04 free -h
total used free shared buff/cache available
Expand Down