mirror of
https://github.com/k3s-io/k3s.git
synced 2024-06-07 19:41:36 +00:00
618b0f98bf
Support repository regex rewrite rules when fetching image content. Example configuration: ```yaml # /etc/rancher/k3s/registries.yaml mirrors: "docker.io": endpoint: - "https://registry-1.docker.io/v2" rewrite: "^library/alpine$": "my-org/alpine" ``` This will instruct k3s containerd to fetch content for `alpine` images from `docker.io/my-org/alpine` instead of the default `docker.io/library/alpine` locations. Signed-off-by: Jacob Blain Christen <jacob@rancher.com>
89 lines
2.4 KiB
Markdown
89 lines
2.4 KiB
Markdown
# continuity
|
|
|
|
[![GoDoc](https://godoc.org/github.com/containerd/continuity?status.svg)](https://godoc.org/github.com/containerd/continuity)
|
|
[![Build Status](https://travis-ci.org/containerd/continuity.svg?branch=master)](https://travis-ci.org/containerd/continuity)
|
|
|
|
A transport-agnostic, filesystem metadata manifest system
|
|
|
|
This project is a staging area for experiments in providing transport agnostic
|
|
metadata storage.
|
|
|
|
Please see https://github.com/opencontainers/specs/issues/11 for more details.
|
|
|
|
## Manifest Format
|
|
|
|
A continuity manifest encodes filesystem metadata in Protocol Buffers.
|
|
Please refer to [proto/manifest.proto](proto/manifest.proto).
|
|
|
|
## Usage
|
|
|
|
Build:
|
|
|
|
```console
|
|
$ make
|
|
```
|
|
|
|
Create a manifest (of this repo itself):
|
|
|
|
```console
|
|
$ ./bin/continuity build . > /tmp/a.pb
|
|
```
|
|
|
|
Dump a manifest:
|
|
|
|
```console
|
|
$ ./bin/continuity ls /tmp/a.pb
|
|
...
|
|
-rw-rw-r-- 270 B /.gitignore
|
|
-rw-rw-r-- 88 B /.mailmap
|
|
-rw-rw-r-- 187 B /.travis.yml
|
|
-rw-rw-r-- 359 B /AUTHORS
|
|
-rw-rw-r-- 11 kB /LICENSE
|
|
-rw-rw-r-- 1.5 kB /Makefile
|
|
...
|
|
-rw-rw-r-- 986 B /testutil_test.go
|
|
drwxrwxr-x 0 B /version
|
|
-rw-rw-r-- 478 B /version/version.go
|
|
```
|
|
|
|
Verify a manifest:
|
|
|
|
```console
|
|
$ ./bin/continuity verify . /tmp/a.pb
|
|
```
|
|
|
|
Break the directory and restore using the manifest:
|
|
```console
|
|
$ chmod 777 Makefile
|
|
$ ./bin/continuity verify . /tmp/a.pb
|
|
2017/06/23 08:00:34 error verifying manifest: resource "/Makefile" has incorrect mode: -rwxrwxrwx != -rw-rw-r--
|
|
$ ./bin/continuity apply . /tmp/a.pb
|
|
$ stat -c %a Makefile
|
|
664
|
|
$ ./bin/continuity verify . /tmp/a.pb
|
|
```
|
|
|
|
## Platforms
|
|
|
|
continuity primarily targets Linux. continuity may compile for and work on
|
|
other operating systems, but those platforms are not tested.
|
|
|
|
## Contribution Guide
|
|
### Building Proto Package
|
|
|
|
If you change the proto file you will need to rebuild the generated Go with `go generate`.
|
|
|
|
```console
|
|
$ go generate ./proto
|
|
```
|
|
|
|
## Project details
|
|
|
|
continuity is a containerd sub-project, licensed under the [Apache 2.0 license](./LICENSE).
|
|
As a containerd sub-project, you will find the:
|
|
* [Project governance](https://github.com/containerd/project/blob/master/GOVERNANCE.md),
|
|
* [Maintainers](https://github.com/containerd/project/blob/master/MAINTAINERS),
|
|
* and [Contributing guidelines](https://github.com/containerd/project/blob/master/CONTRIBUTING.md)
|
|
|
|
information in our [`containerd/project`](https://github.com/containerd/project) repository.
|