Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lxc/go-lxc
Go bindings for liblxc
https://github.com/lxc/go-lxc
containers go lxc
Last synced: 5 days ago
JSON representation
Go bindings for liblxc
- Host: GitHub
- URL: https://github.com/lxc/go-lxc
- Owner: lxc
- License: other
- Created: 2014-02-18T22:58:36.000Z (over 10 years ago)
- Default Branch: v2
- Last Pushed: 2024-06-06T20:02:41.000Z (5 months ago)
- Last Synced: 2024-06-19T13:17:00.760Z (5 months ago)
- Topics: containers, go, lxc
- Language: Go
- Homepage: https://linuxcontainers.org/lxc
- Size: 768 KB
- Stars: 423
- Watchers: 37
- Forks: 77
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
[](https://linuxcontainers.org/)
# Go Bindings for LXC (Linux Containers)
LXC is the well-known and heavily tested low-level Linux container runtime. It
is in active development since 2008 and has proven itself in critical
production environments world-wide. Some of its core contributors are the same
people that helped to implement various well-known containerization features
inside the Linux kernel.
This package implements [Go](https://golang.org) bindings for the [LXC](https://linuxcontainers.org/lxc/introduction/) C API (liblxc).
## Status
Type | Service | Status
--- | --- | ---
CI (Linux) | Github | [](https://github.com/lxc/go-lxc/actions/workflows/test.yml)
Go documentation | Godoc | [](https://godoc.org/github.com/lxc/go-lxc)
Static analysis | GoReport | [](https://goreportcard.com/report/github.com/lxc/go-lxc)
## Requirements
This package requires [LXC >= 1.0.0](https://github.com/lxc/lxc/releases) and its development package and their dependencies to be installed. Additionally, go-lxc requires Golang 1.10 or later to work. Following command should install required dependencies on Ubuntu 18.10:
```bash
sudo apt update
sudo apt install git golang gcc make liblxc1 liblxc-dev lxc-utils pkg-config
```
## Installing
To install it, run:
```bash
go get github.com/lxc/go-lxc
```
## Trying
To try examples, run:
```bash
# cd ~/go/src/github.com/lxc/go-lxc/examples/
# make
==> Running go vet
==> Building ...
...
# create/create
2018/12/27 22:39:27 Creating container...
# start/start
2018/12/27 22:39:39 Starting the container...
2018/12/27 22:39:39 Waiting container to startup networking...
# attach/attach
2018/12/27 22:39:46 AttachShell
root@rubik:/# hostname
rubik
root@rubik:/# exit
exit
2018/12/27 22:39:52 RunCommand
uid=0(root) gid=0(root) groups=0(root)
# stop/stop
2018/12/27 22:39:54 Stopping the container...
# destroy/destroy
2018/12/27 22:39:57 Destroying container...
```
## Backwards Compatibility
LXC has always focused on strong backwards compatibility. In fact, the API hasn't been broken from release `1.0.0` onwards. Main LXC is currently at version `2.*.*`.
## Examples
See the [examples](https://github.com/lxc/go-lxc/tree/v2/examples) directory for some.
## Bug reports
Bug reports can be filed at:
## Contributing
Fixes and new features are greatly appreciated. We'd love to see go-lxc improve. To contribute to go-lxc;
* **Fork** the repository
* **Modify** your fork
* Ensure your fork **passes all tests**
* **Send** a pull request
* Bonus points if the pull request includes *what* you changed, *why* you changed it, and *tests* attached.
## Getting help
When you find you need help, the LXC projects provides you with several options.
### Discuss Forum
We maintain an discuss forum at
- https://discuss.linuxcontainers.org/
where you can get support.
### IRC
You can find support by joining `#lxcontainers` on `Freenode`.
### Mailing Lists
You can check out one of the two LXC mailing list archives and register if interested:
- http://lists.linuxcontainers.org/listinfo/lxc-devel
- http://lists.linuxcontainers.org/listinfo/lxc-users