1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00

Fix formatting, change to markdown block for long

Signed-off-by: Joe Ferguson <joe@infosiftr.com>
This commit is contained in:
Joe Ferguson 2014-09-08 15:59:16 -06:00
parent 5b6c4051d5
commit bcb9378c5b

View file

@ -41,7 +41,7 @@ Official Image.
document](TODO: link). In addition, Docker, Inc. engineer Michael Crosby has a good
discussion of Dockerfiles in this [blog post](http://crosbymichael.com/dockerfile-best-practices-take-2.html).
While `[ONBUILD triggers]`(https://docs.docker.com/reference/builder/#onbuild) are not
While [`ONBUILD` triggers](https://docs.docker.com/reference/builder/#onbuild) are not
required, if you choose to use them you should:
* Build both `ONBUILD` and non-`ONBUILD` images, with the `ONBUILD` image built `FROM`
@ -86,7 +86,6 @@ In terms of content, the long description must include the following sections:
* Overview & Links
* How-to/Usage
* User Feedback
* License
#### Overview & links
@ -121,7 +120,7 @@ contacts, additional “how-to” information or other resources.
Include a file, `LICENSE`, of any applicable license. Docker recommends using the
license of the software contained in the image, provided it allows Docker, Inc. to
legally build and distribute the image. Otherwise Docker recommends adopting the
[Expat license]((http://directory.fsf.org/wiki/License:Expat).
[Expat license](http://directory.fsf.org/wiki/License:Expat).
## Examples
@ -130,51 +129,41 @@ Ruby on Rails.
### Short description
README-short.txt
Ruby on Rails is an open-source application framework written in Ruby. It emphasizes
best practices such as convention over configuration, active record pattern, and the
model-view-controller pattern.
`README-short.txt`
`Ruby on Rails is an open-source application framework written in Ruby. It emphasizes best practices such as convention over configuration, active record pattern, and the model-view-controller pattern.`
### Long description
README.md
# What is Ruby on Rails
Ruby on Rails, often simply referred to as Rails, is an open source web application
framework which runs via the Ruby programming language. It is a full-stack framework:
it allows creating pages and applications that gather information from the web server,
talk to or query the database, and render templates out of the box. As a result, Rails
features a routing system that is independent of the web server.
[wikipedia.org/wiki/Ruby_on_Rails](https://en.wikipedia.org/wiki/Ruby_on_Rails)
**How to use this image**
1. create a `Dockerfile` in your rails app project
FROM rails:onbuild
Put this file in the root of your app, next to the `Gemfile`.
`README.md`
```markdown
# What is Ruby on Rails
Ruby on Rails, often simply referred to as Rails, is an open source web application framework which runs via the Ruby programming language. It is a full-stack framework: it allows creating pages and applications that gather information from the web server, talk to or query the database, and render templates out of the box. As a result, Rails features a routing system that is independent of the web server.
> [wikipedia.org/wiki/Ruby_on_Rails](https://en.wikipedia.org/wiki/Ruby_on_Rails)
# How to use this image
## Create a `Dockerfile` in your rails app project
FROM rails:onbuild
Put this file in the root of your app, next to the `Gemfile`.
This image includes multiple `ONBUILD` triggers so that should be all that you need for most applications. The build will `ADD . /usr/src/app`, `RUN bundle install`, `EXPOSE 3000`, and set the default command to `rails server`.
Then build and run the docker image.
This image includes multiple `ONBUILD` triggers so that should be all that you need
for most applications. The build will `ADD . /usr/src/app`, `RUN bundle install`,
`EXPOSE 3000`, and set the default command to `rails server`.
2. build the rails app image
docker build -t my-rails-app .
3. start the rails app container
docker run --name some-rails-app -d my-rails-app
Then go to `http://container-ip:3000` in a browser. On the other hand, if you need access
outside the host on port 8080:
Test it by visiting `http://container-ip:3000` in a browser. On the other hand, if you need access outside the host on port 8080:
docker run --name some-rails-app -p 8080:3000 -d my-rails-app
Then go to `http://localhost:8080` or `http://host-ip:8080` in a browser.
Then hit `http://localhost:8080` or `http://host-ip:8080` in a browser.
```
For more examples, take a look at these repos: <TODO links>