1
0
mirror of https://github.com/rancher/os.git synced 2025-06-25 22:41:36 +00:00
Mirror from github
Go to file
2015-05-02 23:06:20 -07:00
assets Fix more issues with state management 2015-02-16 22:27:32 -07:00
cmd remove default directory from tls generate cmd 2015-04-29 04:38:43 -07:00
config Rename userdocker to docker to be more consistent with other distros 2015-05-02 23:06:20 -07:00
docker Changes required due to labels type change in ServiceConfig 2015-04-29 20:48:57 -07:00
docs Delete .DS_Store 2015-04-24 17:29:35 +09:00
Godeps Godep changes 2015-04-30 22:16:02 -07:00
init Merge pull request #270 from ibuildthecloud/stuff 2015-05-01 11:58:38 -07:00
scripts Rename userdocker to docker to be more consistent with other distros 2015-05-02 23:06:20 -07:00
util use SplitN instead of manual split 2015-04-30 13:43:45 +05:00
.dockerignore Update ignores 2015-03-18 06:45:21 -07:00
.drone.yml CI scripts 2015-02-17 17:01:38 -07:00
.gitignore revert .gitignore 2015-04-29 17:19:59 +05: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 Dynamically set version for ubuntu console 2015-03-20 12:43:24 -07:00
LICENSE Remove incorrect copyright 2015-02-25 10:22:56 -07:00
main.go Wait for userdocker to start 2015-04-04 09:55:41 -07:00
README.md change documentation sub-title to RancherOS 2015-04-28 12:50:57 -07:00

RancherOS

The smallest, easiest way to run Docker in production at scale. Everything in RancherOS is a container managed by Docker. This includes system services such as udev and rsyslog. RancherOS includes only the bare minimum amount of software needed to run Docker. This keeps the binary download of RancherOS to about 20MB. Everything else can be pulled in dynamically through Docker.

How this works

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. The user Docker is then the instance that gets primarily used to create containers. We created this separation because it seemed logical and also it would really be bad if somebody did docker rm -f $(docker ps -qa) and deleted the entire OS.

How it works

Latest Release

v0.3.0 - Docker 1.6.0 - Linux 3.19.2

ISO

https://github.com/rancherio/os/releases/download/v0.3.0/rancheros.iso

Amazon

We have 2 different virtualization types of AMIs. SSH keys are added to the rancher user, so you must log in using the rancher user.

Paravirtual

Region Type AMI
ap-northeast-1 PV ami-506da950
ap-southeast-1 PV ami-14043946
ap-southeast-2 PV ami-37acd10d
eu-west-1 PV ami-2d8fec5a
sa-east-1 PV ami-fd7ffae0
us-east-1 PV ami-ca3e39a2
us-west-1 PV ami-55816c11
us-west-2 PV ami-29c1f419

HVM

HVM was introduced in v0.3.0 and only supports v0.3.0+.

Region Type AMI
ap-northeast-1 HVM ami-be6da9be
ap-southeast-1 HVM ami-06043954
ap-southeast-2 HVM ami-23acd119
eu-west-1 HVM ami-018fec76
sa-east-1 HVM ami-f17ffaec
us-east-1 HVM ami-b03e39d8
us-west-1 HVM ami-6d816c29
us-west-2 HVM ami-1fc1f42f

Google Compute Engine (Experimental)

We are providing a disk image that users can download and import for use in Google Compute Engine. The image can be obtained from the release artifacts for RancherOS v0.3.0.

Download Image

Import

To import the image into your project follow the instructions below:

Usage

The image supports RancherOS cloud config functionality. Additionally, it merges the SSH keys from the project, instance and cloud-config and adds them to the rancher user.

Known issues/ToDos

  • Add GCE daemon support. (Manages users)

Documentation for RancherOS

Please refer to our website to read all about RancherOS. It has detailed information on how it works, getting-started and other details.

Support, Discussion, and Community

If you need any help with RancherOS or Rancher, please join us at either our rancherio Google Groups or #rancher IRC channel where most of our team hangs out at.

Please submit any RancherOS bugs, issues, and feature requests to rancherio/os.

Please submit any Rancher bugs, issues, and feature requests to rancherio/rancher.

#License Copyright (c) 2014-2015 Rancher Labs, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.