x
/
loci-keystone
Code Issues Proposed changes

Update README.md to point to main repo 

Change-Id: I2a0fe54b2c88915548ca30a89a0f03824a6ef8dd
This commit is contained in:
Sam Yaple 2017-03-27 18:29:00 +00:00
parent cffd3bd88d
commit 13b2c1d8a0
1 changed files with 2 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
README.md
View File

@ -1,9 +1,6 @@
# OpenStack yaodu/keystone
[![Docker Automated buil](https://img.shields.io/docker/automated/yaodu/keystone.svg)](https://hub.docker.com/r/yaodu/keystone/)
# OpenStack LOCI-keystone
Yaodu/keystone is a set of Dockerfiles that builds lightweight deployment agnostic images for OpenStack Keystone.
Images are built in the Docker Hub automatically on each push to the master branch to provide a continuously updated set of images based on a number of distributions. Additionally, this repo may be cloned and used to build images for OpenStack Keystone either for development purposes or as part of a CI/CD workflow.
For more information, including build instructions, please visit the [main repository](https://github.com/openstack/loci).
### Image Layer Info
[![](https://images.microbadger.com/badges/version/yaodu/keystone:latest.svg)](https://microbadger.com/images/yaodu/keystone:latest "yaodu/keystone:latest") [![](https://images.microbadger.com/badges/image/yaodu/keystone:latest.svg)](https://microbadger.com/images/yaodu/keystone:latest "yaodu/keystone:latest")
@ -11,45 +8,3 @@ Images are built in the Docker Hub automatically on each push to the master bran
[![](https://images.microbadger.com/badges/version/yaodu/keystone:ubuntu.svg)](https://microbadger.com/images/yaodu/keystone:ubuntu "yaodu/keystone:ubuntu") [![](https://images.microbadger.com/badges/image/yaodu/keystone:ubuntu.svg)](https://microbadger.com/images/yaodu/keystone:ubuntu "yaodu/keystone:ubuntu")
[![](https://images.microbadger.com/badges/version/yaodu/keystone:centos.svg)](https://microbadger.com/images/yaodu/keystone:centos "yaodu/keystone:centos") [![](https://images.microbadger.com/badges/image/yaodu/keystone:centos.svg)](https://microbadger.com/images/yaodu/keystone:centos "yaodu/keystone:centos")
### Building locally
It's really easy to build images locally for the distro of your choice. To build an image you only need to run:
``` bash
$ docker build https://github.com/yaodu/docker-keystone.git \
--file debian/Dockerfile \
--tag yaodu/keystone:latest
```
You can, of course, substitute `debian` with your distro of choice.
For more advanced building you can use docker build arguments to define:
* The git repo containing the OpenStack project the container should contain, `GIT_REPO`
* The git ref the container should use when building, `GIT_REF`
* The git repo the container should use when building from a git ref, `GIT_REF_REPO`
* The docker image name to use for the base requirements python wheels, `DOCKER_REPO`
* The docker image tag to use for the base requirements python wheels, `DOCKER_TAG`
* If present, rather than using a docker image containing OpenStack requirements a tarball will be used from the defined URL, `WHEELS`
This makes it really easy to integrate Yaodu images into your development or CI/CD workflow, for example, if you wanted to build an image from [this PS](https://review.openstack.org/#/c/418167/) you could run:
``` bash
$ docker build https://github.com/yaodu/docker-keystone.git \
--file ubuntu/Dockerfile \
--tag mydockernamespace/keystone-testing:418167-1 \
--build-arg GIT_REPO=http://git.openstack.org/openstack/keystone.git \
--build-arg GIT_REF_REPO=http://git.openstack.org/openstack/keystone.git \
--build-arg GIT_REF=refs/changes/67/418167/1
```
### Customizing
The images should contain all the required assets for running the service. But if you wish or need to customize the `yaodu/keystone` image that's great! We hope to have built the images to make this as easy and flexible as possible. To do this we recommend that you perform any required customisation in a child image using a pattern similar to:
``` Dockerfile
FROM yaodu/keystone:latest
MAINTAINER you@example.com
RUN set -x \
&& apt-get update \
&& apt-get install -y --no-install-recommends \
your-awesome-binary-package \
&& rm -rf /var/lib/apt/lists/*
```