Skip to content

slecache/api-console-docker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 

Repository files navigation

api:Console in Docker

A Docker image to run the api:Console for your REST API documentation with RAML.

Installation

Download from Docker Hub

docker pull slecache/api-console

Build Docker Image

docker build -t slecache/api-console .

Demo

Play With Docker

Your can start your free swarm server for 4 hours by clicking on the following button:

Try in PWD

Dply.co

Your can start your free demo server for 2 hours by clicking on the following button:

Dply

Quick start

How to use this image

docker run -p 9000:9000 -d slecache/api-console

Then, access it via http://localhost:9000 in a browser.

How to deploy your API

Your main RAML file MUST be named main.raml.

Mounting local volume

docker run -v /your_local_folder_where_are_your_raml_files:/data/dist/apis --name DATA busybox true
docker run --volumes-from DATA -p 9000:9000 -p 35729:35729 -d slecache/api-console

Please note that the live reload is activated. The edition of any files in your folder will provoke the auto-reloading of your api:Console in your browser.

Building custom image

At the root of your RAML documentation folder where the main.raml MUST be present, create the following Dockerfile:

FROM slecache/api-console

Then, run the build command :

docker build -t your_image_name .

All yours documentations files will be copied in the /data/dist/apis of the Docker Image.

User feedback

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

About

A Docker base image for the api:Console

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published