Remove github.com/docker/docker from vendor
Signed-off-by: Vincent Demeester <vincent@sbr.pm>
This commit is contained in:
parent
3ca4c78b1a
commit
03ca562be1
|
@ -15,7 +15,6 @@ github.com/coreos/pkg v3
|
||||||
github.com/godbus/dbus v3
|
github.com/godbus/dbus v3
|
||||||
github.com/golang/protobuf 18c9bb3261723cd5401db4d0c9fbc5c3b6c70fe8
|
github.com/golang/protobuf 18c9bb3261723cd5401db4d0c9fbc5c3b6c70fe8
|
||||||
# Command-line interface.
|
# Command-line interface.
|
||||||
github.com/docker/docker 0f5c9d301b9b1cca66b3ea0f9dec3b5317d3686d
|
|
||||||
github.com/cyphar/filepath-securejoin v0.2.1
|
github.com/cyphar/filepath-securejoin v0.2.1
|
||||||
github.com/docker/go-units v0.2.0
|
github.com/docker/go-units v0.2.0
|
||||||
github.com/urfave/cli d53eb991652b1d438abdd34ce4bfa3ef1539108e
|
github.com/urfave/cli d53eb991652b1d438abdd34ce4bfa3ef1539108e
|
||||||
|
|
|
@ -1,191 +0,0 @@
|
||||||
|
|
||||||
Apache License
|
|
||||||
Version 2.0, January 2004
|
|
||||||
https://www.apache.org/licenses/
|
|
||||||
|
|
||||||
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
||||||
|
|
||||||
1. Definitions.
|
|
||||||
|
|
||||||
"License" shall mean the terms and conditions for use, reproduction,
|
|
||||||
and distribution as defined by Sections 1 through 9 of this document.
|
|
||||||
|
|
||||||
"Licensor" shall mean the copyright owner or entity authorized by
|
|
||||||
the copyright owner that is granting the License.
|
|
||||||
|
|
||||||
"Legal Entity" shall mean the union of the acting entity and all
|
|
||||||
other entities that control, are controlled by, or are under common
|
|
||||||
control with that entity. For the purposes of this definition,
|
|
||||||
"control" means (i) the power, direct or indirect, to cause the
|
|
||||||
direction or management of such entity, whether by contract or
|
|
||||||
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
||||||
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
||||||
|
|
||||||
"You" (or "Your") shall mean an individual or Legal Entity
|
|
||||||
exercising permissions granted by this License.
|
|
||||||
|
|
||||||
"Source" form shall mean the preferred form for making modifications,
|
|
||||||
including but not limited to software source code, documentation
|
|
||||||
source, and configuration files.
|
|
||||||
|
|
||||||
"Object" form shall mean any form resulting from mechanical
|
|
||||||
transformation or translation of a Source form, including but
|
|
||||||
not limited to compiled object code, generated documentation,
|
|
||||||
and conversions to other media types.
|
|
||||||
|
|
||||||
"Work" shall mean the work of authorship, whether in Source or
|
|
||||||
Object form, made available under the License, as indicated by a
|
|
||||||
copyright notice that is included in or attached to the work
|
|
||||||
(an example is provided in the Appendix below).
|
|
||||||
|
|
||||||
"Derivative Works" shall mean any work, whether in Source or Object
|
|
||||||
form, that is based on (or derived from) the Work and for which the
|
|
||||||
editorial revisions, annotations, elaborations, or other modifications
|
|
||||||
represent, as a whole, an original work of authorship. For the purposes
|
|
||||||
of this License, Derivative Works shall not include works that remain
|
|
||||||
separable from, or merely link (or bind by name) to the interfaces of,
|
|
||||||
the Work and Derivative Works thereof.
|
|
||||||
|
|
||||||
"Contribution" shall mean any work of authorship, including
|
|
||||||
the original version of the Work and any modifications or additions
|
|
||||||
to that Work or Derivative Works thereof, that is intentionally
|
|
||||||
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
||||||
or by an individual or Legal Entity authorized to submit on behalf of
|
|
||||||
the copyright owner. For the purposes of this definition, "submitted"
|
|
||||||
means any form of electronic, verbal, or written communication sent
|
|
||||||
to the Licensor or its representatives, including but not limited to
|
|
||||||
communication on electronic mailing lists, source code control systems,
|
|
||||||
and issue tracking systems that are managed by, or on behalf of, the
|
|
||||||
Licensor for the purpose of discussing and improving the Work, but
|
|
||||||
excluding communication that is conspicuously marked or otherwise
|
|
||||||
designated in writing by the copyright owner as "Not a Contribution."
|
|
||||||
|
|
||||||
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
||||||
on behalf of whom a Contribution has been received by Licensor and
|
|
||||||
subsequently incorporated within the Work.
|
|
||||||
|
|
||||||
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
copyright license to reproduce, prepare Derivative Works of,
|
|
||||||
publicly display, publicly perform, sublicense, and distribute the
|
|
||||||
Work and such Derivative Works in Source or Object form.
|
|
||||||
|
|
||||||
3. Grant of Patent License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
(except as stated in this section) patent license to make, have made,
|
|
||||||
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
||||||
where such license applies only to those patent claims licensable
|
|
||||||
by such Contributor that are necessarily infringed by their
|
|
||||||
Contribution(s) alone or by combination of their Contribution(s)
|
|
||||||
with the Work to which such Contribution(s) was submitted. If You
|
|
||||||
institute patent litigation against any entity (including a
|
|
||||||
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
||||||
or a Contribution incorporated within the Work constitutes direct
|
|
||||||
or contributory patent infringement, then any patent licenses
|
|
||||||
granted to You under this License for that Work shall terminate
|
|
||||||
as of the date such litigation is filed.
|
|
||||||
|
|
||||||
4. Redistribution. You may reproduce and distribute copies of the
|
|
||||||
Work or Derivative Works thereof in any medium, with or without
|
|
||||||
modifications, and in Source or Object form, provided that You
|
|
||||||
meet the following conditions:
|
|
||||||
|
|
||||||
(a) You must give any other recipients of the Work or
|
|
||||||
Derivative Works a copy of this License; and
|
|
||||||
|
|
||||||
(b) You must cause any modified files to carry prominent notices
|
|
||||||
stating that You changed the files; and
|
|
||||||
|
|
||||||
(c) You must retain, in the Source form of any Derivative Works
|
|
||||||
that You distribute, all copyright, patent, trademark, and
|
|
||||||
attribution notices from the Source form of the Work,
|
|
||||||
excluding those notices that do not pertain to any part of
|
|
||||||
the Derivative Works; and
|
|
||||||
|
|
||||||
(d) If the Work includes a "NOTICE" text file as part of its
|
|
||||||
distribution, then any Derivative Works that You distribute must
|
|
||||||
include a readable copy of the attribution notices contained
|
|
||||||
within such NOTICE file, excluding those notices that do not
|
|
||||||
pertain to any part of the Derivative Works, in at least one
|
|
||||||
of the following places: within a NOTICE text file distributed
|
|
||||||
as part of the Derivative Works; within the Source form or
|
|
||||||
documentation, if provided along with the Derivative Works; or,
|
|
||||||
within a display generated by the Derivative Works, if and
|
|
||||||
wherever such third-party notices normally appear. The contents
|
|
||||||
of the NOTICE file are for informational purposes only and
|
|
||||||
do not modify the License. You may add Your own attribution
|
|
||||||
notices within Derivative Works that You distribute, alongside
|
|
||||||
or as an addendum to the NOTICE text from the Work, provided
|
|
||||||
that such additional attribution notices cannot be construed
|
|
||||||
as modifying the License.
|
|
||||||
|
|
||||||
You may add Your own copyright statement to Your modifications and
|
|
||||||
may provide additional or different license terms and conditions
|
|
||||||
for use, reproduction, or distribution of Your modifications, or
|
|
||||||
for any such Derivative Works as a whole, provided Your use,
|
|
||||||
reproduction, and distribution of the Work otherwise complies with
|
|
||||||
the conditions stated in this License.
|
|
||||||
|
|
||||||
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
||||||
any Contribution intentionally submitted for inclusion in the Work
|
|
||||||
by You to the Licensor shall be under the terms and conditions of
|
|
||||||
this License, without any additional terms or conditions.
|
|
||||||
Notwithstanding the above, nothing herein shall supersede or modify
|
|
||||||
the terms of any separate license agreement you may have executed
|
|
||||||
with Licensor regarding such Contributions.
|
|
||||||
|
|
||||||
6. Trademarks. This License does not grant permission to use the trade
|
|
||||||
names, trademarks, service marks, or product names of the Licensor,
|
|
||||||
except as required for reasonable and customary use in describing the
|
|
||||||
origin of the Work and reproducing the content of the NOTICE file.
|
|
||||||
|
|
||||||
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
||||||
agreed to in writing, Licensor provides the Work (and each
|
|
||||||
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
||||||
implied, including, without limitation, any warranties or conditions
|
|
||||||
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
||||||
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
||||||
appropriateness of using or redistributing the Work and assume any
|
|
||||||
risks associated with Your exercise of permissions under this License.
|
|
||||||
|
|
||||||
8. Limitation of Liability. In no event and under no legal theory,
|
|
||||||
whether in tort (including negligence), contract, or otherwise,
|
|
||||||
unless required by applicable law (such as deliberate and grossly
|
|
||||||
negligent acts) or agreed to in writing, shall any Contributor be
|
|
||||||
liable to You for damages, including any direct, indirect, special,
|
|
||||||
incidental, or consequential damages of any character arising as a
|
|
||||||
result of this License or out of the use or inability to use the
|
|
||||||
Work (including but not limited to damages for loss of goodwill,
|
|
||||||
work stoppage, computer failure or malfunction, or any and all
|
|
||||||
other commercial damages or losses), even if such Contributor
|
|
||||||
has been advised of the possibility of such damages.
|
|
||||||
|
|
||||||
9. Accepting Warranty or Additional Liability. While redistributing
|
|
||||||
the Work or Derivative Works thereof, You may choose to offer,
|
|
||||||
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
||||||
or other liability obligations and/or rights consistent with this
|
|
||||||
License. However, in accepting such obligations, You may act only
|
|
||||||
on Your own behalf and on Your sole responsibility, not on behalf
|
|
||||||
of any other Contributor, and only if You agree to indemnify,
|
|
||||||
defend, and hold each Contributor harmless for any liability
|
|
||||||
incurred by, or claims asserted against, such Contributor by reason
|
|
||||||
of your accepting any such warranty or additional liability.
|
|
||||||
|
|
||||||
END OF TERMS AND CONDITIONS
|
|
||||||
|
|
||||||
Copyright 2013-2015 Docker, 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
|
|
||||||
|
|
||||||
https://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.
|
|
|
@ -1,19 +0,0 @@
|
||||||
Docker
|
|
||||||
Copyright 2012-2015 Docker, Inc.
|
|
||||||
|
|
||||||
This product includes software developed at Docker, Inc. (https://www.docker.com).
|
|
||||||
|
|
||||||
This product contains software (https://github.com/kr/pty) developed
|
|
||||||
by Keith Rarick, licensed under the MIT License.
|
|
||||||
|
|
||||||
The following is courtesy of our legal counsel:
|
|
||||||
|
|
||||||
|
|
||||||
Use and transfer of Docker may be subject to certain restrictions by the
|
|
||||||
United States and other governments.
|
|
||||||
It is your responsibility to ensure that your use and/or transfer does not
|
|
||||||
violate applicable laws.
|
|
||||||
|
|
||||||
For more information, please see https://www.bis.doc.gov
|
|
||||||
|
|
||||||
See also https://www.apache.org/dev/crypto.html and/or seek legal counsel.
|
|
|
@ -1,295 +0,0 @@
|
||||||
Docker: the Linux container engine
|
|
||||||
==================================
|
|
||||||
|
|
||||||
Docker is an open source project to pack, ship and run any application
|
|
||||||
as a lightweight container.
|
|
||||||
|
|
||||||
Docker containers are both *hardware-agnostic* and *platform-agnostic*.
|
|
||||||
This means they can run anywhere, from your laptop to the largest
|
|
||||||
EC2 compute instance and everything in between - and they don't require
|
|
||||||
you to use a particular language, framework or packaging system. That
|
|
||||||
makes them great building blocks for deploying and scaling web apps,
|
|
||||||
databases, and backend services without depending on a particular stack
|
|
||||||
or provider.
|
|
||||||
|
|
||||||
Docker began as an open-source implementation of the deployment engine which
|
|
||||||
powers [dotCloud](https://dotcloud.com), a popular Platform-as-a-Service.
|
|
||||||
It benefits directly from the experience accumulated over several years
|
|
||||||
of large-scale operation and support of hundreds of thousands of
|
|
||||||
applications and databases.
|
|
||||||
|
|
||||||
![Docker L](docs/static_files/docker-logo-compressed.png "Docker")
|
|
||||||
|
|
||||||
## Security Disclosure
|
|
||||||
|
|
||||||
Security is very important to us. If you have any issue regarding security,
|
|
||||||
please disclose the information responsibly by sending an email to
|
|
||||||
security@docker.com and not by creating a github issue.
|
|
||||||
|
|
||||||
## Better than VMs
|
|
||||||
|
|
||||||
A common method for distributing applications and sandboxing their
|
|
||||||
execution is to use virtual machines, or VMs. Typical VM formats are
|
|
||||||
VMware's vmdk, Oracle VirtualBox's vdi, and Amazon EC2's ami. In theory
|
|
||||||
these formats should allow every developer to automatically package
|
|
||||||
their application into a "machine" for easy distribution and deployment.
|
|
||||||
In practice, that almost never happens, for a few reasons:
|
|
||||||
|
|
||||||
* *Size*: VMs are very large which makes them impractical to store
|
|
||||||
and transfer.
|
|
||||||
* *Performance*: running VMs consumes significant CPU and memory,
|
|
||||||
which makes them impractical in many scenarios, for example local
|
|
||||||
development of multi-tier applications, and large-scale deployment
|
|
||||||
of cpu and memory-intensive applications on large numbers of
|
|
||||||
machines.
|
|
||||||
* *Portability*: competing VM environments don't play well with each
|
|
||||||
other. Although conversion tools do exist, they are limited and
|
|
||||||
add even more overhead.
|
|
||||||
* *Hardware-centric*: VMs were designed with machine operators in
|
|
||||||
mind, not software developers. As a result, they offer very
|
|
||||||
limited tooling for what developers need most: building, testing
|
|
||||||
and running their software. For example, VMs offer no facilities
|
|
||||||
for application versioning, monitoring, configuration, logging or
|
|
||||||
service discovery.
|
|
||||||
|
|
||||||
By contrast, Docker relies on a different sandboxing method known as
|
|
||||||
*containerization*. Unlike traditional virtualization, containerization
|
|
||||||
takes place at the kernel level. Most modern operating system kernels
|
|
||||||
now support the primitives necessary for containerization, including
|
|
||||||
Linux with [openvz](https://openvz.org),
|
|
||||||
[vserver](http://linux-vserver.org) and more recently
|
|
||||||
[lxc](https://linuxcontainers.org/), Solaris with
|
|
||||||
[zones](https://docs.oracle.com/cd/E26502_01/html/E29024/preface-1.html#scrolltoc),
|
|
||||||
and FreeBSD with
|
|
||||||
[Jails](https://www.freebsd.org/doc/handbook/jails.html).
|
|
||||||
|
|
||||||
Docker builds on top of these low-level primitives to offer developers a
|
|
||||||
portable format and runtime environment that solves all four problems.
|
|
||||||
Docker containers are small (and their transfer can be optimized with
|
|
||||||
layers), they have basically zero memory and cpu overhead, they are
|
|
||||||
completely portable, and are designed from the ground up with an
|
|
||||||
application-centric design.
|
|
||||||
|
|
||||||
Perhaps best of all, because Docker operates at the OS level, it can still be
|
|
||||||
run inside a VM!
|
|
||||||
|
|
||||||
## Plays well with others
|
|
||||||
|
|
||||||
Docker does not require you to buy into a particular programming
|
|
||||||
language, framework, packaging system, or configuration language.
|
|
||||||
|
|
||||||
Is your application a Unix process? Does it use files, tcp connections,
|
|
||||||
environment variables, standard Unix streams and command-line arguments
|
|
||||||
as inputs and outputs? Then Docker can run it.
|
|
||||||
|
|
||||||
Can your application's build be expressed as a sequence of such
|
|
||||||
commands? Then Docker can build it.
|
|
||||||
|
|
||||||
## Escape dependency hell
|
|
||||||
|
|
||||||
A common problem for developers is the difficulty of managing all
|
|
||||||
their application's dependencies in a simple and automated way.
|
|
||||||
|
|
||||||
This is usually difficult for several reasons:
|
|
||||||
|
|
||||||
* *Cross-platform dependencies*. Modern applications often depend on
|
|
||||||
a combination of system libraries and binaries, language-specific
|
|
||||||
packages, framework-specific modules, internal components
|
|
||||||
developed for another project, etc. These dependencies live in
|
|
||||||
different "worlds" and require different tools - these tools
|
|
||||||
typically don't work well with each other, requiring awkward
|
|
||||||
custom integrations.
|
|
||||||
|
|
||||||
* *Conflicting dependencies*. Different applications may depend on
|
|
||||||
different versions of the same dependency. Packaging tools handle
|
|
||||||
these situations with various degrees of ease - but they all
|
|
||||||
handle them in different and incompatible ways, which again forces
|
|
||||||
the developer to do extra work.
|
|
||||||
|
|
||||||
* *Custom dependencies*. A developer may need to prepare a custom
|
|
||||||
version of their application's dependency. Some packaging systems
|
|
||||||
can handle custom versions of a dependency, others can't - and all
|
|
||||||
of them handle it differently.
|
|
||||||
|
|
||||||
|
|
||||||
Docker solves the problem of dependency hell by giving the developer a simple
|
|
||||||
way to express *all* their application's dependencies in one place, while
|
|
||||||
streamlining the process of assembling them. If this makes you think of
|
|
||||||
[XKCD 927](https://xkcd.com/927/), don't worry. Docker doesn't
|
|
||||||
*replace* your favorite packaging systems. It simply orchestrates
|
|
||||||
their use in a simple and repeatable way. How does it do that? With
|
|
||||||
layers.
|
|
||||||
|
|
||||||
Docker defines a build as running a sequence of Unix commands, one
|
|
||||||
after the other, in the same container. Build commands modify the
|
|
||||||
contents of the container (usually by installing new files on the
|
|
||||||
filesystem), the next command modifies it some more, etc. Since each
|
|
||||||
build command inherits the result of the previous commands, the
|
|
||||||
*order* in which the commands are executed expresses *dependencies*.
|
|
||||||
|
|
||||||
Here's a typical Docker build process:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
FROM ubuntu:12.04
|
|
||||||
RUN apt-get update && apt-get install -y python python-pip curl
|
|
||||||
RUN curl -sSL https://github.com/shykes/helloflask/archive/master.tar.gz | tar -xzv
|
|
||||||
RUN cd helloflask-master && pip install -r requirements.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
Note that Docker doesn't care *how* dependencies are built - as long
|
|
||||||
as they can be built by running a Unix command in a container.
|
|
||||||
|
|
||||||
|
|
||||||
Getting started
|
|
||||||
===============
|
|
||||||
|
|
||||||
Docker can be installed on your local machine as well as servers - both
|
|
||||||
bare metal and virtualized. It is available as a binary on most modern
|
|
||||||
Linux systems, or as a VM on Windows, Mac and other systems.
|
|
||||||
|
|
||||||
We also offer an [interactive tutorial](https://www.docker.com/tryit/)
|
|
||||||
for quickly learning the basics of using Docker.
|
|
||||||
|
|
||||||
For up-to-date install instructions, see the [Docs](https://docs.docker.com).
|
|
||||||
|
|
||||||
Usage examples
|
|
||||||
==============
|
|
||||||
|
|
||||||
Docker can be used to run short-lived commands, long-running daemons
|
|
||||||
(app servers, databases, etc.), interactive shell sessions, etc.
|
|
||||||
|
|
||||||
You can find a [list of real-world
|
|
||||||
examples](https://docs.docker.com/examples/) in the
|
|
||||||
documentation.
|
|
||||||
|
|
||||||
Under the hood
|
|
||||||
--------------
|
|
||||||
|
|
||||||
Under the hood, Docker is built on the following components:
|
|
||||||
|
|
||||||
* The
|
|
||||||
[cgroups](https://www.kernel.org/doc/Documentation/cgroups/cgroups.txt)
|
|
||||||
and
|
|
||||||
[namespaces](http://man7.org/linux/man-pages/man7/namespaces.7.html)
|
|
||||||
capabilities of the Linux kernel
|
|
||||||
* The [Go](https://golang.org) programming language
|
|
||||||
* The [Docker Image Specification](https://github.com/docker/docker/blob/master/image/spec/v1.md)
|
|
||||||
* The [Libcontainer Specification](https://github.com/docker/libcontainer/blob/master/SPEC.md)
|
|
||||||
|
|
||||||
Contributing to Docker
|
|
||||||
======================
|
|
||||||
|
|
||||||
[![GoDoc](https://godoc.org/github.com/docker/docker?status.svg)](https://godoc.org/github.com/docker/docker)
|
|
||||||
[![Jenkins Build Status](https://jenkins.dockerproject.org/job/Docker%20Master/badge/icon)](https://jenkins.dockerproject.org/job/Docker%20Master/)
|
|
||||||
|
|
||||||
Want to hack on Docker? Awesome! We have [instructions to help you get
|
|
||||||
started contributing code or documentation](https://docs.docker.com/project/who-written-for/).
|
|
||||||
|
|
||||||
These instructions are probably not perfect, please let us know if anything
|
|
||||||
feels wrong or incomplete. Better yet, submit a PR and improve them yourself.
|
|
||||||
|
|
||||||
Getting the development builds
|
|
||||||
==============================
|
|
||||||
|
|
||||||
Want to run Docker from a master build? You can download
|
|
||||||
master builds at [master.dockerproject.org](https://master.dockerproject.org).
|
|
||||||
They are updated with each commit merged into the master branch.
|
|
||||||
|
|
||||||
Don't know how to use that super cool new feature in the master build? Check
|
|
||||||
out the master docs at
|
|
||||||
[docs.master.dockerproject.org](http://docs.master.dockerproject.org).
|
|
||||||
|
|
||||||
How the project is run
|
|
||||||
======================
|
|
||||||
|
|
||||||
Docker is a very, very active project. If you want to learn more about how it is run,
|
|
||||||
or want to get more involved, the best place to start is [the project directory](https://github.com/docker/docker/tree/master/project).
|
|
||||||
|
|
||||||
We are always open to suggestions on process improvements, and are always looking for more maintainers.
|
|
||||||
|
|
||||||
### Talking to other Docker users and contributors
|
|
||||||
|
|
||||||
<table class="tg">
|
|
||||||
<col width="45%">
|
|
||||||
<col width="65%">
|
|
||||||
<tr>
|
|
||||||
<td>Internet Relay Chat (IRC)</td>
|
|
||||||
<td>
|
|
||||||
<p>
|
|
||||||
IRC a direct line to our most knowledgeable Docker users; we have
|
|
||||||
both the <code>#docker</code> and <code>#docker-dev</code> group on
|
|
||||||
<strong>irc.freenode.net</strong>.
|
|
||||||
IRC is a rich chat protocol but it can overwhelm new users. You can search
|
|
||||||
<a href="https://botbot.me/freenode/docker/#" target="_blank">our chat archives</a>.
|
|
||||||
</p>
|
|
||||||
Read our <a href="https://docs.docker.com/project/get-help/#irc-quickstart" target="_blank">IRC quickstart guide</a> for an easy way to get started.
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>Google Groups</td>
|
|
||||||
<td>
|
|
||||||
There are two groups.
|
|
||||||
<a href="https://groups.google.com/forum/#!forum/docker-user" target="_blank">Docker-user</a>
|
|
||||||
is for people using Docker containers.
|
|
||||||
The <a href="https://groups.google.com/forum/#!forum/docker-dev" target="_blank">docker-dev</a>
|
|
||||||
group is for contributors and other people contributing to the Docker
|
|
||||||
project.
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>Twitter</td>
|
|
||||||
<td>
|
|
||||||
You can follow <a href="https://twitter.com/docker/" target="_blank">Docker's Twitter feed</a>
|
|
||||||
to get updates on our products. You can also tweet us questions or just
|
|
||||||
share blogs or stories.
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td>Stack Overflow</td>
|
|
||||||
<td>
|
|
||||||
Stack Overflow has over 7000K Docker questions listed. We regularly
|
|
||||||
monitor <a href="https://stackoverflow.com/search?tab=newest&q=docker" target="_blank">Docker questions</a>
|
|
||||||
and so do many other knowledgeable Docker users.
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
### Legal
|
|
||||||
|
|
||||||
*Brought to you courtesy of our legal counsel. For more context,
|
|
||||||
please see the [NOTICE](https://github.com/docker/docker/blob/master/NOTICE) document in this repo.*
|
|
||||||
|
|
||||||
Use and transfer of Docker may be subject to certain restrictions by the
|
|
||||||
United States and other governments.
|
|
||||||
|
|
||||||
It is your responsibility to ensure that your use and/or transfer does not
|
|
||||||
violate applicable laws.
|
|
||||||
|
|
||||||
For more information, please see https://www.bis.doc.gov
|
|
||||||
|
|
||||||
|
|
||||||
Licensing
|
|
||||||
=========
|
|
||||||
Docker is licensed under the Apache License, Version 2.0. See
|
|
||||||
[LICENSE](https://github.com/docker/docker/blob/master/LICENSE) for the full
|
|
||||||
license text.
|
|
||||||
|
|
||||||
Other Docker Related Projects
|
|
||||||
=============================
|
|
||||||
There are a number of projects under development that are based on Docker's
|
|
||||||
core technology. These projects expand the tooling built around the
|
|
||||||
Docker platform to broaden its application and utility.
|
|
||||||
|
|
||||||
* [Docker Registry](https://github.com/docker/distribution): Registry
|
|
||||||
server for Docker (hosting/delivery of repositories and images)
|
|
||||||
* [Docker Machine](https://github.com/docker/machine): Machine management
|
|
||||||
for a container-centric world
|
|
||||||
* [Docker Swarm](https://github.com/docker/swarm): A Docker-native clustering
|
|
||||||
system
|
|
||||||
* [Docker Compose](https://github.com/docker/compose) (formerly Fig):
|
|
||||||
Define and run multi-container apps
|
|
||||||
* [Kitematic](https://github.com/kitematic/kitematic): The easiest way to use
|
|
||||||
Docker on Mac and Windows
|
|
||||||
|
|
||||||
If you know of another project underway that should be listed here, please help
|
|
||||||
us keep this list up-to-date by submitting a PR.
|
|
|
@ -1,11 +0,0 @@
|
||||||
pkg/ is a collection of utility packages used by the Docker project without being specific to its internals.
|
|
||||||
|
|
||||||
Utility packages are kept separate from the docker core codebase to keep it as small and concise as possible.
|
|
||||||
If some utilities grow larger and their APIs stabilize, they may be moved to their own repository under the
|
|
||||||
Docker organization, to facilitate re-use by other projects. However that is not the priority.
|
|
||||||
|
|
||||||
The directory `pkg` is named after the same directory in the camlistore project. Since Brad is a core
|
|
||||||
Go maintainer, we thought it made sense to copy his methods for organizing Go code :) Thanks Brad!
|
|
||||||
|
|
||||||
Because utility packages are small and neatly separated from the rest of the codebase, they are a good
|
|
||||||
place to start for aspiring maintainers and contributors. Get in touch if you want to help maintain them!
|
|
Loading…
Reference in New Issue