mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
Merge pull request #2253 from jpetazzo/infrastructure-docs
Try a different presentation of infrastructure documentation.
This commit is contained in:
Jérôme Petazzoni
commit
95ccb78aa7
2 changed files with 80 additions and 105 deletions
|
|
@ -1,5 +1,83 @@
|
||||||
# Docker project infrastructure
|
# Docker project infrastructure
|
||||||
|
|
||||||
This directory holds all information about the technical infrastructure of the docker project; servers, dns, email, and all the corresponding tools and configuration.
|
This is an overview of the Docker infrastructure.
|
||||||
|
|
||||||
Obviously credentials should not be stored in this repo, but how to obtain and use them should be documented here.
|
**Note: obviously, credentials should not be stored in this repository.**
|
||||||
|
However, when there are credentials, we should list how to obtain them
|
||||||
|
(e.g. who has them).
|
||||||
|
|
||||||
|
|
||||||
|
## Providers
|
||||||
|
|
||||||
|
This should be the list of all the entities providing some kind of
|
||||||
|
infrastructure service to the Docker project (either for free,
|
||||||
|
or paid by dotCloud).
|
||||||
|
|
||||||
|
|
||||||
|
Provider | Service
|
||||||
|
--------------|-------------------------------------------------
|
||||||
|
AWS | packages (S3 bucket), dotCloud PAAS, dev-env, ci
|
||||||
|
CloudFlare | cdn
|
||||||
|
Digital Ocean | ci
|
||||||
|
dotCloud PAAS | website, index, registry, ssl, blog
|
||||||
|
DynECT | dns (docker.io)
|
||||||
|
GitHub | repository
|
||||||
|
Linode | stackbrew
|
||||||
|
Mailgun | outgoing e-mail
|
||||||
|
ReadTheDocs | docs
|
||||||
|
|
||||||
|
*Ordered-by: lexicographic*
|
||||||
|
|
||||||
|
|
||||||
|
## URLs
|
||||||
|
|
||||||
|
This should be the list of all the infrastructure-related URLs
|
||||||
|
and which service is handling them.
|
||||||
|
|
||||||
|
URL | Service
|
||||||
|
---------------------------------------------|---------------------------------
|
||||||
|
http://blog.docker.io/ | blog
|
||||||
|
*http://cdn-registry-1.docker.io/ | registry (pull)
|
||||||
|
http://debug.docker.io/ | debug tool
|
||||||
|
http://docs.docker.io/ | docsproxy (proxy to readthedocs)
|
||||||
|
http://docker-ci.dotcloud.com/ | ci
|
||||||
|
http://docker.io/ | redirect to www.docker.io (dynect)
|
||||||
|
http://docker.readthedocs.org/ | docs
|
||||||
|
*http://get.docker.io/ | packages
|
||||||
|
https://github.com/dotcloud/docker | repository
|
||||||
|
*https://index.docker.io/ | index
|
||||||
|
http://registry-1.docker.io/ | registry (push)
|
||||||
|
http://staging-docker-ci.dotcloud.com/ | ci
|
||||||
|
*http://test.docker.io/ | packages
|
||||||
|
*http://www.docker.io/ | website
|
||||||
|
http://? (internal URL, not for public use) | stackbrew
|
||||||
|
|
||||||
|
*Ordered-by: lexicographic*
|
||||||
|
|
||||||
|
**Note:** an asterisk in front of the URL means that it is cached by CloudFlare.
|
||||||
|
|
||||||
|
|
||||||
|
## Services
|
||||||
|
|
||||||
|
This should be the list of all services referenced above.
|
||||||
|
|
||||||
|
Service | Maintainer(s) | How to update | Source
|
||||||
|
--------------------|--------------------|------------------|-------
|
||||||
|
blog | @jbarbier | dotcloud push | https://github.com/dotcloud/blog.docker.io
|
||||||
|
cdn | @jpetazzo @samalba | cloudflare panel | N/A
|
||||||
|
ci | @mzdaniel | See [docker-ci] | See [docker-ci]
|
||||||
|
docs | @metalivedev | github webhook | docker repo
|
||||||
|
docsproxy | @dhrp | dotcloud push | https://github.com/dotcloud/docker-docs-dotcloud-proxy
|
||||||
|
index | @kencochrane | dotcloud push | private
|
||||||
|
packages | @jpetazzo | hack/release | docker repo
|
||||||
|
registry | @samalba | dotcloud push | https://github.com/dotcloud/docker-registry
|
||||||
|
repository (github) | N/A | N/A | N/A
|
||||||
|
ssl (dotcloud) | @jpetazzo | dotcloud ops | N/A
|
||||||
|
ssl (cloudflare) | @jpetazzo | cloudflare panel | N/A
|
||||||
|
stackbrew | @shin- | manual | https://github.com/dotcloud/stackbrew/stackbrew
|
||||||
|
website | @dhrp | dotcloud push | https://github.com/dotcloud/www.docker.io
|
||||||
|
|
||||||
|
*Ordered-by: lexicographic*
|
||||||
|
|
||||||
|
|
||||||
|
[docker-ci]: docker-ci.rst
|
||||||
|
|
|
||||||
|
|
@ -1,103 +0,0 @@
|
||||||
# Docker Server Overview
|
|
||||||
This is an overview of the Docker infrastructure
|
|
||||||
|
|
||||||
## Docker Git Repo
|
|
||||||
The Docker source code lives on github.com under the dotCloud account.
|
|
||||||
https://github.com/dotcloud/docker
|
|
||||||
|
|
||||||
## DNS
|
|
||||||
We are using dyn.com for our DNS server for the docker.io domain.
|
|
||||||
It is using the dotCloud account.
|
|
||||||
|
|
||||||
### DNS Redirect
|
|
||||||
We have a DNS redirect in dyn.com that will automatically redirect
|
|
||||||
docker.io to www.docker.io
|
|
||||||
|
|
||||||
## email
|
|
||||||
Email is sent via dotCloud account on MailGun.com
|
|
||||||
|
|
||||||
## CDN
|
|
||||||
We are using a CDN in front of some of the docker.io domains to help improve
|
|
||||||
proformance. The CDN is Cloudflare, using a Pro account.
|
|
||||||
|
|
||||||
*This is currently disabled due to an issue with slow performance during pull
|
|
||||||
in some regions of the world.*
|
|
||||||
|
|
||||||
### CDN Domains
|
|
||||||
- www.docker.io
|
|
||||||
- test.docker.io
|
|
||||||
- registry-1.docker.io
|
|
||||||
- debug.docker.io
|
|
||||||
- cdn-registry-1.docker.io
|
|
||||||
|
|
||||||
## edge-docker.dotcloud.com
|
|
||||||
All of the Docker applications that live on dotCloud go through their own
|
|
||||||
load balancer, and this is where SSL is terminated as well.
|
|
||||||
|
|
||||||
## www.docker.io
|
|
||||||
This is hosted under the docker account on dotCloud's PaaS.
|
|
||||||
|
|
||||||
### Source Code
|
|
||||||
The source code for the website lives here:
|
|
||||||
https://github.com/dotcloud/www.docker.io
|
|
||||||
|
|
||||||
## Docker Registry
|
|
||||||
The registry is where the image data is store.
|
|
||||||
|
|
||||||
### URL:
|
|
||||||
- registry-1.docker.io
|
|
||||||
- cdn-registry-1.docker.io
|
|
||||||
|
|
||||||
There are two urls, one is behind a CDN the other isn't this is because when
|
|
||||||
you pull, you pull from the CDN url, to help with pull speeds. We don't push
|
|
||||||
through the CDN as well, because it doesn't help us, so we bypass it.
|
|
||||||
|
|
||||||
### Data Store:
|
|
||||||
The data store for the registry is using Amazon S3 in a bucket under the docker
|
|
||||||
aws account.
|
|
||||||
|
|
||||||
### Source Code
|
|
||||||
The source code for the registry lives here: https://github.com/dotcloud/docker-registry
|
|
||||||
|
|
||||||
### Hosted:
|
|
||||||
Hosted on the Docker account on dotCloud's PaaS
|
|
||||||
|
|
||||||
## index.docker.io
|
|
||||||
This is the docker index, it stores all of the meta information about the
|
|
||||||
docker images, but all data is stored in the registry.
|
|
||||||
|
|
||||||
### Source Code:
|
|
||||||
Not available
|
|
||||||
|
|
||||||
### Hosted:
|
|
||||||
Hosted on the Docker account on dotCloud's PaaS
|
|
||||||
|
|
||||||
## blog.docker.io
|
|
||||||
This is a wordpress based Docker blog.
|
|
||||||
|
|
||||||
### URL:
|
|
||||||
http://blog.docker.io
|
|
||||||
|
|
||||||
### Source Code:
|
|
||||||
https://github.com/dotcloud/blog.docker.io
|
|
||||||
|
|
||||||
## docs.docker.io
|
|
||||||
This is where all of the documentation for docker lives.
|
|
||||||
|
|
||||||
### Hosted:
|
|
||||||
This website is hosted on ReadTheDocs.org.
|
|
||||||
|
|
||||||
### Updates
|
|
||||||
These docs get automatically updated when the Docker repo on github has
|
|
||||||
new commits. It does this via a webhook.
|
|
||||||
|
|
||||||
### Proxy:
|
|
||||||
This is a simple dotcloud app, with its main and only purpose to forward
|
|
||||||
http (and https) requests to docker.readthedocs.org.
|
|
||||||
|
|
||||||
https://github.com/dotcloud/docker-docs-dotcloud-proxy
|
|
||||||
|
|
||||||
## get.docker.io
|
|
||||||
This is the docker repository where we store images
|
|
||||||
|
|
||||||
TODO: need more here. jerome?
|
|
||||||
Loading…
Reference in a new issue