1
0
mirror of https://github.com/rancher/os.git synced 2025-06-24 22:11:33 +00:00
Mirror from github
Go to file
Darren Shepherd cbda9cfbb1 Add docs
2015-02-21 00:47:18 -07:00
assets Fix more issues with state management 2015-02-16 22:27:32 -07:00
cmd Cleanup logging 2015-02-21 00:34:23 -07:00
config Save ssh keys 2015-02-21 00:34:38 -07:00
docker Add rancher user and lock root 2015-02-20 11:29:17 -07:00
docs Add docs 2015-02-21 00:47:18 -07:00
Godeps Update godeps 2015-02-19 20:05:52 -07:00
init Cleanup logging 2015-02-21 00:34:23 -07:00
scripts Update os-base 2015-02-21 00:35:08 -07:00
util Refactor tlsconf 2015-02-19 13:48:10 -07:00
.dockerignore Initial commit 2015-02-08 21:38:37 -07:00
.drone.yml CI scripts 2015-02-17 17:01:38 -07:00
.gitignore Ignore assets 2015-02-19 13:48:27 -07:00
.package Initial commit 2015-02-08 21:38:37 -07:00
.wrap-docker-args Initial commit 2015-02-08 21:38:37 -07:00
build.sh Delete build install container 2015-02-21 00:33:47 -07:00
main.go Further cleanup and refactoring 2015-02-19 20:05:43 -07:00
README.md Add docs 2015-02-21 00:47:18 -07:00

RancherOS

It's containers all the way down! Everything is powered by Docker (I mean everything).

Building

Docker 1.5+ required.

./build.sh

Running

KVM, VirtualBox, and VMware all supported (Clouds and Vagrant coming soon). Just boot from the rancheros.iso from the releases page.

Logging in

Log in with rancher/rancher and use sudo to get root access.

Once cloud-init integration is finished we will not need to hard code the password anymore.

Persisting State

Create a partition with the label RANCHER_STATE, for example

mkfs.ext4 -L RANCHER_STATE /dev/sda

Configuring

The entire state of RancherOS is controlled by a single configuration document. You can edit the configuration with the rancherctl config command.

Commands

docker -- Good old Docker, use that to run stuff.

system-docker -- The docker instance running the system containers. Must run as root

rancherctl -- Control and configure RancherOS

How does this work

Everything in RancherOS is a Docker container. We accomplish this by launching two instances of Docker. One is what we call the system Docker which runs as PID 1. System Docker then launches a container that runs the user Docker. We created this separation as is really seemed like a bad idea that if somebody did docker rm -f $(docker ps -qa) they would delete the entire OS.

How it works