You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Bump cOS to 0.6.0
Signed-off-by: Ettore Di Giacinto <[email protected]>
* Update README by pointing to docs
Signed-off-by: Ettore Di Giacinto <[email protected]>
* Bump cloud-config
Signed-off-by: Ettore Di Giacinto <[email protected]>
Copy file name to clipboardExpand all lines: README.md
+5-73Lines changed: 5 additions & 73 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,49 +1,10 @@
1
-
# containerOS toolkit
1
+
# [](https://github.com/rancher-sandbox/cOS-toolkit/actions/workflows/build-master.yaml)containerOS toolkit
2
2
3
-
containerOS (**cOS**) is a toolkit to build, ship and maintain cloud-init driven Linux derivatives based on container images with a common featureset.
3
+
containerOS (**cOS**) is a toolkit to build, ship and maintain cloud-init driven Linux derivatives based on container images with a common featureset - allows container images to be bootable in VMs, baremetals, embedded devices, and much more.
4
4
5
5
It is designed to reduce the maintenance surface, with a flexible approach to provide upgrades from container registries. It is cloud-init driven and also designed to be adaptive-first, allowing easily to build changes on top.
6
6
7
-
[Documentation is available at https://rancher-sandbox.github.io/cos-toolkit-docs/docs](https://rancher-sandbox.github.io/cos-toolkit-docs/docs)
8
-
9
-
<!-- TOC -->
10
-
11
-
-[containerOS toolkit](#containeros-toolkit)
12
-
-[In a nutshell](#in-a-nutshell)
13
-
-[Releases](#releases)
14
-
-[Design goals](#design-goals)
15
-
-[Build cOS Locally](#build-cos-locally)
16
-
-[First steps](#first-steps)
17
-
-[Samples](#samples)
18
-
-[cOS development](#cos-development)
19
-
-[License](#license)
20
-
21
-
<!-- /TOC -->
22
-
23
-
## In a nutshell
24
-
25
-
cOS derivatives are built from containers, and completely hosted on image registries. The build process results in a single container image used to deliver regular upgrades in OTA approach. Each derivative built with `cos-toolkit` inherits a default featureset.
26
-
27
-
cOS supports different release channels, all the final and cache images used are tagged and pushed regularly [to Quay Container Registry](https://quay.io/repository/costoolkit/releases-green) and can be pulled for inspection from the registry as well.
28
-
29
-
Those are exactly the same images used during upgrades, and can also be used to build Linux derivatives from cOS.
30
-
31
-
For example, if you want to see locally what's in a openSUSE cOS version , you can:
32
-
33
-
```bash
34
-
$ docker run -ti --rm quay.io/costoolkit/releases-green:cos-system-$VERSION /bin/bash
35
-
```
36
-
37
-
## Releases
38
-
39
-
cOS-toolkit releases consist on container images that can be used to build derived against and the cos source tree itself.
40
-
41
-
cOS is a manifest which assembles an OS from containers, so if you want to make substantial changes to the layout you can also fork directly cOS.
42
-
43
-
Currently, the toolkit supports creating derivatives from [OpenSUSE (green), Fedora (blue) and Ubuntu (orange)](https://github.com/rancher-sandbox/cOS-toolkit/tree/master/values), although it's rather simple to add support for other OS families and architecures.
44
-
45
-
The cOS CI generates ISO and images artifacts used for testing, so you can also try out cOS by downloading the
46
-
ISO [from the Github Actions page](https://github.com/rancher-sandbox/cOS-toolkit/actions/workflows/build.yaml), to the commit you are interested into.
7
+
Documentation is available at [https://rancher-sandbox.github.io/cos-toolkit-docs/docs](https://rancher-sandbox.github.io/cos-toolkit-docs/docs)
47
8
48
9
## Design goals
49
10
@@ -56,38 +17,9 @@ ISO [from the Github Actions page](https://github.com/rancher-sandbox/cOS-toolki
56
17
- Easy to customize
57
18
- Cryptographically verified
58
19
59
-
### Build cOS Locally
60
-
61
-
The starting point to use cos-toolkit is to see it in action with our [sample repository](https://github.com/rancher-sandbox/cos-toolkit-sample-repo) or check out our `examples` folder, see also [creating bootable images](https://rancher-sandbox.github.io/cos-toolkit-docs/docs/creating-derivatives/creating_bootable_images/).
62
-
63
-
The only requirement to build derivatives with `cos-toolkit` is docker installed, see [Development notes](https://rancher-sandbox.github.io/cos-toolkit-docs/docs/development/) for more details on how to build `cos` instead.
64
-
65
-
## First steps
66
-
67
-
The [sample repository](https://github.com/rancher-sandbox/cos-toolkit-sample-repo) contains the definitions of a [SampleOS](https://github.com/rancher-sandbox/cos-toolkit-sample-repo/tree/master/packages/sampleOS) boilerplate, which results in an immutable single-image distro and a [simple HTTP service on top](https://github.com/rancher-sandbox/cos-toolkit-sample-repo/tree/master/packages/sampleOSService) that gets started on boot.
68
-
69
-
To give it a quick shot, it's as simple as cloning the [Github repository](https://github.com/rancher-sandbox/cos-toolkit-sample-repo), and running cos-build:
This command will build a container image which contains the required dependencies to build the custom OS, and will later be used to build the OS itself. The result will be a set of container images and an ISO which you can boot with your environment of choice. See [Creating derivatives](https://rancher-sandbox.github.io/cos-toolkit-docs/docs/creating-derivatives/creating_derivatives/) for more details about the process.
79
-
80
-
If you are looking after only generating a container image that can be used for upgrades from the cOS vanilla images, see [creating bootable images](https://rancher-sandbox.github.io/cos-toolkit-docs/docs/creating-derivatives/creating_bootable_images/) and see also [how to drive upgrades with Fleet](https://rancher-sandbox.github.io/cos-toolkit-docs/docs/tutorials/trigger_upgrades_with_fleet/).
0 commit comments