github.com/coreos/rocket@v1.30.1-0.20200224141603-171c416fac02/README.md (about)

     1  ## :warning: End of project :warning:
     2  
     3  [![development](https://img.shields.io/badge/development-halted-red.svg)](https://github.com/rkt/rkt/issues/4024)
     4  
     5  This project [has ended](https://github.com/rkt/rkt/issues/4024), and **all development/maintenance activities have halted**.
     6  
     7  As it is free software, people are free and welcome to fork and develop the codebase on their own.
     8  However, to avoid any confusion, the original repository is archived and we recommend any further fork/development to proceed with an explicit rename and rebranding first.
     9  
    10  We encourage all interested parties to mirror any relevant bits as we can't actively guarantee their existence in the future.
    11  
    12  ---
    13  
    14  # rkt - the pod-native container engine
    15  
    16  [![godoc](https://godoc.org/github.com/rkt/rkt?status.svg)](http://godoc.org/github.com/rkt/rkt)
    17  [![Build Status (Travis)](https://travis-ci.org/rkt/rkt.svg?branch=master)](https://travis-ci.org/rkt/rkt)
    18  [![Build Status (SemaphoreCI)](https://semaphoreci.com/api/v1/rkt/rkt/branches/master/badge.svg)](https://semaphoreci.com/rkt/rkt)
    19  [![Go Report Card](https://goreportcard.com/badge/github.com/rkt/rkt)](https://goreportcard.com/report/github.com/rkt/rkt)
    20  
    21  ![rkt Logo](logos/rkt-horizontal-color.png)
    22  
    23  rkt (pronounced like a _"rocket"_) is a CLI for running application containers on Linux. rkt is designed to be secure, composable, and standards-based.
    24  
    25  Some of rkt's key features and goals include:
    26  
    27  - _Pod-native_: rkt's basic unit of execution is a [pod][coreos-rkt-pod-blog], linking together resources and user applications in a self-contained environment.
    28  - _Security_: rkt is developed with a principle of "secure-by-default", and includes a number of important security features like support for [SELinux][selinux], [TPM measurement][tpm], and running app containers in [hardware-isolated VMs][kvm].
    29  - _Composability_: rkt is designed for first-class integration with init systems (like [systemd][systemd], upstart) and cluster orchestration tools (like [Kubernetes][kubernetes] and [Nomad][nomad]), and supports [swappable execution engines][architecture].
    30  - _Open standards and compatibility_: rkt implements the [appc specification][rkt-and-appc], supports the [Container Networking Interface specification][cni], and can run [Docker images][docker] and [OCI images][oci-image-spec]. Broader native support for OCI images and runtimes is [in development][rkt-oci].
    31  
    32  [coreos-rkt-pod-blog]: https://coreos.com/blog/rkt-and-kubernetes.html
    33  [architecture]: Documentation/devel/architecture.md
    34  [systemd]: Documentation/using-rkt-with-systemd.md
    35  [kubernetes]: Documentation/using-rkt-with-kubernetes.md
    36  [nomad]: Documentation/using-rkt-with-nomad.md
    37  [docker]: Documentation/running-docker-images.md
    38  [networking]: Documentation/networking.md
    39  [kvm]: Documentation/running-kvm-stage1.md
    40  [rkt-and-appc]: Documentation/app-container.md
    41  [cni]: https://github.com/containernetworking/cni
    42  [selinux]: Documentation/selinux.md
    43  [tpm]: Documentation/devel/tpm.md
    44  [oci-image-spec]: https://github.com/opencontainers/image-spec
    45  [rkt-oci]: https://github.com/rkt/rkt/projects/4
    46  
    47  ## Project status
    48  
    49  The rkt v1.x series provides command line user interface and on-disk data structures stability for external development. Any major changes to those primary areas will be clearly communicated, and a formal deprecation process conducted for any retired features.
    50  
    51  Check out the [roadmap](ROADMAP.md) for more details on the future of rkt.
    52  
    53  ## Trying out rkt
    54  
    55  To get started quickly using rkt for the first time, start with the ["trying out rkt" document](Documentation/trying-out-rkt.md).
    56  Also check [rkt support on your Linux distribution](Documentation/distributions.md).
    57  For an end-to-end example of building an application from scratch and running it with rkt, check out the [getting started guide](Documentation/getting-started-guide.md).
    58  
    59  ## Getting help with rkt
    60  
    61  There are a number of different avenues for seeking help and communicating with the rkt community:
    62  - For bugs and feature requests (including documentation!), file an [issue][new-issue]
    63  - For general discussion about both using and developing rkt, join the [rkt-dev][rkt-dev] mailing list
    64  - For real-time discussion, join us on IRC: #[rkt-dev][irc] on freenode.org
    65  - For more details on rkt development plans, check out the GitHub [milestones][milestones]
    66  
    67  Most discussion about rkt development happens on GitHub via issues and pull requests.
    68  The rkt developers also host a semi-regular community sync meeting open to the public.
    69  This sync usually features demos, updates on the roadmap, and time for anyone from the community to ask questions of the developers or share users stories with others.
    70  For more details, including how to join and recordings of previous syncs, see the [sync doc on Google Docs][sync-doc].
    71  
    72  [new-issue]: https://github.com/rkt/rkt/issues/new
    73  [rkt-dev]: https://groups.google.com/forum/?hl=en#!forum/rkt-dev
    74  [irc]: irc://irc.freenode.org:6667/#rkt-dev
    75  [milestones]: https://github.com/rkt/rkt/milestones
    76  [sync-doc]: https://docs.google.com/document/d/1NT_J5X2QErtKgd8Y3TFXNknWhJx_yOCMJnq3Iy2jPgE/edit#
    77  
    78  ## Contributing to rkt
    79  
    80  rkt is an open source project and contributions are gladly welcomed!
    81  See the [Hacking Guide](Documentation/hacking.md) for more information on how to build and work on rkt.
    82  See [CONTRIBUTING](CONTRIBUTING.md) for details on submitting patches and the contribution workflow.
    83  
    84  ## Licensing
    85  
    86  Unless otherwise noted, all code in the rkt repository is licensed under the [Apache 2.0 license](LICENSE).
    87  Some portions of the codebase are derived from other projects under different licenses; the appropriate information can be found in the header of those source files, as applicable.
    88  
    89  ## Security disclosure
    90  
    91  If you suspect you have found a security vulnerability in rkt, please *do not* file a GitHub issue, but instead email <security@coreos.com> with the full details, including steps to reproduce the issue.
    92  CoreOS is currently the primary sponsor of rkt development, and all reports are thoroughly investigated by CoreOS engineers.
    93  For more information, see the [CoreOS security disclosure page](https://coreos.com/security/disclosure/).
    94  
    95  ## Known issues
    96  
    97  Check the [troubleshooting document](Documentation/troubleshooting.md).
    98  
    99  ## Related Links
   100  
   101  ### Integrations and Production Users
   102  
   103  - [Projects integrating with rkt](https://github.com/rkt/rkt/blob/master/Documentation/integrations.md)
   104  - [Production users](https://github.com/rkt/rkt/blob/master/Documentation/production-users.md)