README
¶
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.
Latest Release
v0.3.3 - Docker 1.7 - Linux 3.19.2
ISO
https://releases.rancher.com/os/latest/rancheros.iso
https://releases.rancher.com/os/v0.3.3/rancheros.iso
Additional Downloads
https://releases.rancher.com/os/latest/machine-rancheros.iso
https://releases.rancher.com/os/latest/iso-checksums.txt
https://releases.rancher.com/os/latest/rancheros-033-gce-01.tar.gz
https://releases.rancher.com/os/latest/vmlinuz
https://releases.rancher.com/os/latest/initrd
https://releases.rancher.com/os/v0.3.3/machine-rancheros.iso
https://releases.rancher.com/os/v0.3.3/iso-checksums.txt
https://releases.rancher.com/os/v0.3.3/rancheros-033-gce-01.tar.gz
https://releases.rancher.com/os/v0.3.3/vmlinuz
https://releases.rancher.com/os/v0.3.3/initrd
Note: you can use http instead of https in the above URLs, e.g. for iPXE.
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-748a2774 |
| ap-southeast-1 | PV | ami-3ae8e968 |
| ap-southeast-2 | PV | ami-3531750f |
| eu-central-1 | PV | ami-d2b982cf |
| eu-west-1 | PV | ami-fcb7f78b |
| sa-east-1 | PV | ami-6361ec7e |
| us-east-1 | PV | ami-8f2eede4 |
| us-west-1 | PV | ami-77a15133 |
| us-west-2 | PV | ami-bfbfb98f |
HVM
HVM was introduced in v0.3.0 and only supports v0.3.0+.
| Region | Type | AMI |
|---|---|---|
| ap-northeast-1 | HVM | ami-788a2778 |
| ap-southeast-1 | HVM | ami-26e8e974 |
| ap-southeast-2 | HVM | ami-2b317511 |
| eu-central-1 | HVM | ami-c8b982d5 |
| eu-west-1 | HVM | ami-e0b7f797 |
| sa-east-1 | HVM | ami-9f61ec82 |
| us-east-1 | HVM | ami-772dee1c |
| us-west-1 | HVM | ami-19a1515d |
| us-west-2 | HVM | ami-c5bfb9f5 |
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 or later.
Please follow the directions at our docs to launch in GCE.
Known issues/ToDos
- Add GCE daemon support. (Manages users)
Documentation for RancherOS
Please refer to our RancherOS Documentation website to read all about RancherOS. It has detailed information on how RancherOS 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 Rancher forums or #rancher IRC channel where most of our team hangs out at.
Please submit any RancherOS bugs, issues, and feature requests to rancher/os.
Please submit any Rancher bugs, issues, and feature requests to rancher/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.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Godeps
|
|
|
_workspace/src/github.com/codegangsta/cli
Package cli provides a minimal framework for creating and organizing command line Go applications.
|
Package cli provides a minimal framework for creating and organizing command line Go applications. |
|
_workspace/src/github.com/coreos/go-systemd/dbus
Integration with the systemd D-Bus API.
|
Integration with the systemd D-Bus API. |
|
_workspace/src/github.com/coreos/yaml
Package yaml implements YAML support for the Go language.
|
Package yaml implements YAML support for the Go language. |
|
_workspace/src/github.com/docker/distribution
Package distribution will define the interfaces for the components of docker distribution.
|
Package distribution will define the interfaces for the components of docker distribution. |
|
_workspace/src/github.com/docker/distribution/cmd/registry-api-descriptor-template
registry-api-descriptor-template uses the APIDescriptor defined in the api/v2 package to execute templates passed to the command line.
|
registry-api-descriptor-template uses the APIDescriptor defined in the api/v2 package to execute templates passed to the command line. |
|
_workspace/src/github.com/docker/distribution/context
Package context provides several utilities for working with golang.org/x/net/context in http requests.
|
Package context provides several utilities for working with golang.org/x/net/context in http requests. |
|
_workspace/src/github.com/docker/distribution/digest
Package digest provides a generalized type to opaquely represent message digests and their operations within the registry.
|
Package digest provides a generalized type to opaquely represent message digests and their operations within the registry. |
|
_workspace/src/github.com/docker/distribution/health
Package health provides a generic health checking framework.
|
Package health provides a generic health checking framework. |
|
_workspace/src/github.com/docker/distribution/registry
Package registry is a placeholder package for registry interface definitions and utilities.
|
Package registry is a placeholder package for registry interface definitions and utilities. |
|
_workspace/src/github.com/docker/distribution/registry/api/v2
Package v2 describes routes, urls and the error codes used in the Docker Registry JSON HTTP API V2.
|
Package v2 describes routes, urls and the error codes used in the Docker Registry JSON HTTP API V2. |
|
_workspace/src/github.com/docker/distribution/registry/auth
Package auth defines a standard interface for request access controllers.
|
Package auth defines a standard interface for request access controllers. |
|
_workspace/src/github.com/docker/distribution/registry/auth/htpasswd
Package htpasswd provides a simple authentication scheme that checks for the user credential hash in an htpasswd formatted file in a configuration-determined location.
|
Package htpasswd provides a simple authentication scheme that checks for the user credential hash in an htpasswd formatted file in a configuration-determined location. |
|
_workspace/src/github.com/docker/distribution/registry/auth/silly
Package silly provides a simple authentication scheme that checks for the existence of an Authorization header and issues access if is present and non-empty.
|
Package silly provides a simple authentication scheme that checks for the existence of an Authorization header and issues access if is present and non-empty. |
|
_workspace/src/github.com/docker/distribution/registry/storage
Package storage contains storage services for use in the registry application.
|
Package storage contains storage services for use in the registry application. |
|
_workspace/src/github.com/docker/distribution/registry/storage/cache
Package cache provides facilities to speed up access to the storage backend.
|
Package cache provides facilities to speed up access to the storage backend. |
|
_workspace/src/github.com/docker/distribution/registry/storage/driver/azure
Package azure provides a storagedriver.StorageDriver implementation to store blobs in Microsoft Azure Blob Storage Service.
|
Package azure provides a storagedriver.StorageDriver implementation to store blobs in Microsoft Azure Blob Storage Service. |
|
_workspace/src/github.com/docker/distribution/registry/storage/driver/base
Package base provides a base implementation of the storage driver that can be used to implement common checks.
|
Package base provides a base implementation of the storage driver that can be used to implement common checks. |
|
_workspace/src/github.com/docker/distribution/registry/storage/driver/middleware/cloudfront
Package middleware - cloudfront wrapper for storage libs N.B. currently only works with S3, not arbitrary sites
|
Package middleware - cloudfront wrapper for storage libs N.B. currently only works with S3, not arbitrary sites |
|
_workspace/src/github.com/docker/distribution/registry/storage/driver/oss
Package oss implements the Aliyun OSS Storage driver backend.
|
Package oss implements the Aliyun OSS Storage driver backend. |
|
_workspace/src/github.com/docker/distribution/registry/storage/driver/rados
Package rados implements the rados storage driver backend.
|
Package rados implements the rados storage driver backend. |
|
_workspace/src/github.com/docker/distribution/registry/storage/driver/s3
Package s3 provides a storagedriver.StorageDriver implementation to store blobs in Amazon S3 cloud storage.
|
Package s3 provides a storagedriver.StorageDriver implementation to store blobs in Amazon S3 cloud storage. |
|
_workspace/src/github.com/docker/distribution/registry/storage/driver/swift
Package swift provides a storagedriver.StorageDriver implementation to store blobs in Openstack Swift object storage.
|
Package swift provides a storagedriver.StorageDriver implementation to store blobs in Openstack Swift object storage. |
|
_workspace/src/github.com/docker/distribution/uuid
Package uuid provides simple UUID generation.
|
Package uuid provides simple UUID generation. |
|
_workspace/src/github.com/docker/docker/api/client
Package client provides a command-line interface for Docker.
|
Package client provides a command-line interface for Docker. |
|
_workspace/src/github.com/docker/docker/api/types
This package is used for API stability in the types and response to the consumers of the API stats endpoint.
|
This package is used for API stability in the types and response to the consumers of the API stats endpoint. |
|
_workspace/src/github.com/docker/docker/autogen/dockerversion
AUTOGENERATED FILE; see ./hack/make/.go-autogen
|
AUTOGENERATED FILE; see ./hack/make/.go-autogen |
|
_workspace/src/github.com/docker/docker/pkg/parsers
Package parsers provides helper functions to parse and validate different type of string.
|
Package parsers provides helper functions to parse and validate different type of string. |
|
_workspace/src/github.com/docker/docker/pkg/parsers/filters
Package filters provides helper function to parse and handle command line filter, used for example in docker ps or docker images commands.
|
Package filters provides helper function to parse and handle command line filter, used for example in docker ps or docker images commands. |
|
_workspace/src/github.com/docker/docker/pkg/parsers/kernel
Package kernel provides helper function to get, parse and compare kernel versions for different platforms.
|
Package kernel provides helper function to get, parse and compare kernel versions for different platforms. |
|
_workspace/src/github.com/docker/docker/pkg/parsers/operatingsystem
Package operatingsystem provides helper function to get the operating system name for different platforms.
|
Package operatingsystem provides helper function to get the operating system name for different platforms. |
|
_workspace/src/github.com/docker/docker/pkg/pools
Package pools provides a collection of pools which provide various data types with buffers.
|
Package pools provides a collection of pools which provide various data types with buffers. |
|
_workspace/src/github.com/docker/docker/pkg/stringid
Package stringid provides helper functions for dealing with string identifiers
|
Package stringid provides helper functions for dealing with string identifiers |
|
_workspace/src/github.com/docker/docker/pkg/tarsum
Package tarsum provides algorithms to perform checksum calculation on filesystem layers.
|
Package tarsum provides algorithms to perform checksum calculation on filesystem layers. |
|
_workspace/src/github.com/docker/docker/pkg/term
Package term provides provides structures and helper functions to work with terminal (state, sizes).
|
Package term provides provides structures and helper functions to work with terminal (state, sizes). |
|
_workspace/src/github.com/docker/docker/pkg/timeutils
Package timeutils provides helper functions to parse and print time (time.Time).
|
Package timeutils provides helper functions to parse and print time (time.Time). |
|
_workspace/src/github.com/docker/docker/pkg/tlsconfig
Package tlsconfig provides primitives to retrieve secure-enough TLS configurations for both clients and servers.
|
Package tlsconfig provides primitives to retrieve secure-enough TLS configurations for both clients and servers. |
|
_workspace/src/github.com/docker/docker/pkg/ulimit
Package ulimit provides structure and helper function to parse and represent resource limits (Rlimit and Ulimit, its human friendly version).
|
Package ulimit provides structure and helper function to parse and represent resource limits (Rlimit and Ulimit, its human friendly version). |
|
_workspace/src/github.com/docker/docker/pkg/units
Package units provides helper function to parse and print size and time units in human-readable format.
|
Package units provides helper function to parse and print size and time units in human-readable format. |
|
_workspace/src/github.com/docker/docker/pkg/urlutil
Package urlutil provides helper function to check urls kind.
|
Package urlutil provides helper function to check urls kind. |
|
_workspace/src/github.com/docker/docker/pkg/useragent
Package useragent provides helper functions to pack version information into a single User-Agent header.
|
Package useragent provides helper functions to pack version information into a single User-Agent header. |
|
_workspace/src/github.com/docker/docker/volume/local
Package local provides the default implementation for volumes.
|
Package local provides the default implementation for volumes. |
|
_workspace/src/github.com/docker/libcontainer/netlink
Packet netlink provide access to low level Netlink sockets and messages.
|
Packet netlink provide access to low level Netlink sockets and messages. |
|
_workspace/src/github.com/docker/libnetwork/resolvconf
Package resolvconf provides utility code to query and update DNS configuration in /etc/resolv.conf
|
Package resolvconf provides utility code to query and update DNS configuration in /etc/resolv.conf |
|
_workspace/src/github.com/docker/libtrust
Package libtrust provides an interface for managing authentication and authorization using public key cryptography.
|
Package libtrust provides an interface for managing authentication and authorization using public key cryptography. |
|
_workspace/src/github.com/fsouza/go-dockerclient
Package docker provides a client for the Docker remote API.
|
Package docker provides a client for the Docker remote API. |
|
_workspace/src/github.com/fsouza/go-dockerclient/testing
Package testing provides a fake implementation of the Docker API, useful for testing purpose.
|
Package testing provides a fake implementation of the Docker API, useful for testing purpose. |
|
_workspace/src/github.com/gorilla/context
Package context stores values shared during a request lifetime.
|
Package context stores values shared during a request lifetime. |
|
_workspace/src/github.com/gorilla/mux
Package gorilla/mux implements a request router and dispatcher.
|
Package gorilla/mux implements a request router and dispatcher. |
|
_workspace/src/github.com/guelfey/go.dbus
Package dbus implements bindings to the D-Bus message bus system.
|
Package dbus implements bindings to the D-Bus message bus system. |
|
_workspace/src/github.com/guelfey/go.dbus/introspect
Package introspect provides some utilities for dealing with the DBus introspection format.
|
Package introspect provides some utilities for dealing with the DBus introspection format. |
|
_workspace/src/github.com/guelfey/go.dbus/prop
Package prop provides the Properties struct which can be used to implement org.freedesktop.DBus.Properties.
|
Package prop provides the Properties struct which can be used to implement org.freedesktop.DBus.Properties. |
|
_workspace/src/github.com/j-keck/arping
Package arping is a native go library to ping a host per arp datagram, or query a host mac address
|
Package arping is a native go library to ping a host per arp datagram, or query a host mac address |
|
_workspace/src/github.com/kless/term
Package term provides a portable interface for terminal I/O.
|
Package term provides a portable interface for terminal I/O. |
|
_workspace/src/github.com/kless/term/readline
Package readline provides simple functions for both line and screen editing.
|
Package readline provides simple functions for both line and screen editing. |
|
_workspace/src/github.com/kless/term/sys
Package sys contains low-level operating system primitives of the term.
|
Package sys contains low-level operating system primitives of the term. |
|
_workspace/src/github.com/kless/term/test
Package test checks the functions that depend of the standard input, which is changed by `go test` to the standard error.
|
Package test checks the functions that depend of the standard input, which is changed by `go test` to the standard error. |
|
_workspace/src/github.com/stretchr/testify/assert
Package assert provides a set of comprehensive testing tools for use with the normal Go testing system.
|
Package assert provides a set of comprehensive testing tools for use with the normal Go testing system. |
|
_workspace/src/github.com/stretchr/testify/require
Alternative testing tools which stop test execution if test failed.
|
Alternative testing tools which stop test execution if test failed. |
|
_workspace/src/github.com/vishvananda/netlink
Package netlink provides a simple library for netlink.
|
Package netlink provides a simple library for netlink. |
|
_workspace/src/github.com/vishvananda/netlink/nl
Package nl has low level primitives for making Netlink calls.
|
Package nl has low level primitives for making Netlink calls. |
|
_workspace/src/golang.org/x/crypto/ssh/terminal
Package terminal provides support functions for dealing with terminals, as commonly found on UNIX systems.
|
Package terminal provides support functions for dealing with terminals, as commonly found on UNIX systems. |
|
_workspace/src/golang.org/x/net/context
Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes.
|
Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes. |
|
_workspace/src/google.golang.org/cloud/compute/metadata
Package metadata provides access to Google Compute Engine (GCE) metadata and API service accounts.
|
Package metadata provides access to Google Compute Engine (GCE) metadata and API service accounts. |
|
_workspace/src/google.golang.org/cloud/internal
Package internal provides support for the cloud packages.
|
Package internal provides support for the cloud packages. |
|
_workspace/src/google.golang.org/cloud/internal/datastore
Package datastore is a generated protocol buffer package.
|
Package datastore is a generated protocol buffer package. |
|
_workspace/src/google.golang.org/cloud/internal/testutil
Package testutil contains helper functions for writing tests.
|
Package testutil contains helper functions for writing tests. |
|
_workspace/src/gopkg.in/yaml.v2
Package yaml implements YAML support for the Go language.
|
Package yaml implements YAML support for the Go language. |
|
cmd
|
|
Click to show internal directories.
Click to hide internal directories.