Changed occurences of 'docker' to 'Docker' to be in accordance
with Docker Inc's trademark guidelines found here:
https://www.docker.com/trademark-guidelines
This was done due to a pending change that will append Docker
Inc's trademark notice in the kolla docs
TrivialFix
Change-Id: Ie3f385897bfa604986bd99329c0f4b961d3c8552
There were some problems in the documentaiton that
prevented tox -e docs from working. Also changed
attention to WARNING since attention was not as eye-grabbing
as I'd hoped during a previous review.
Change-Id: I2b661afa2cd4a4331bbcc99240d3e127a5d94a11
This will test all rst files inside the doc directory for style issues with
doc8 (an opinionated style checker for rst styles of documentation).
This will fix all syntax issues identified by doc8 and will improve
the syntax.
Change-Id: Id1b9563e07e77e306aef5a0767c98c27f87c5c0e
Small sphinx syntax fixes, better wording, removed pronouns, and
anything else we can think of.
Change-Id: Id7ca8d4673f987d10b520cb1eab77802a043c223
Partially-implements: blueprint documentation-rework
Remove information about build time on specific hardware and reasons
for not pushing images per commit that are not relevant for
a quickstart guide.
Link to detailed instruction about image building from the quickstart
guide and update the image building guide to use `kolla-build` command
by default instead of `tools/build.py`.
Change-Id: If821370acdaaa860c96597aa373687f5f10d3121
Partially-implements: blueprint documentation-rework
Makes sense specify where the docker volume path is present
for image storage in the kolla host as kolla-vagrant does in the
bootstrapping step. With this way users will know where exactly
their images are stored when re-utilize registry containers
Change-Id: I7f5c46ebab8ec4287a40cd6bd34e75eeb919a24f
Restructured the documenation to
1. Add reference at the top
2. Updated the title formatting
3. Updated the heading formatting
4. Updated the links formatting
Change-Id: Ie3786e92fee674da1fa39cf07f1bf0a3badd5b92
Our quickstart guide is way too complex. We need to simplify
the quickstart guide by pulling out the overwhelming amount of
information and splitting it into other docs.
Change-Id: Iec175ee7f60bfd11ce06b22c861e51e180c188a9
Partially-implements: blueprint documentation-rework
Add documentation for the commit I084e5d1cc8f9993d65167878f9983ad58a68e86e.
Explain how 'build.py' picks up automatically env proxy variables.
Change-Id: Ia8513babd4ff72ed52e167b361d6b54393598a78
Closes-Bug: #1538108
Every now and then people ask about plugins for Kolla. This conversation
may need to be revisted in more detail soon, but till then it's worth
highlighting what we do currently support in Kolla.
Right now adding the block as shown in this patch will make the plugin
archive available in the image, but currently only Neutron has
Dockerfile directives to automatically install them if present. The same
can be added very easily for other commonly pluggable services such as
Horizon.
Change-Id: Ia52d5ccf753667c5452b19fcaf4bf5b893a59fd0
We decided during the ODS documentation session that several
documents need retitling. This patch retitles the documents
but doesn't actually adjust the content. There is a separate
patch under work which refactors the content from three documents
into one document.
Change-Id: If5a4718b0ab50c405d42a2e20b7b054b93f3227a
With registry flag,
build image using `tools/build.py --registry 172.22.2.81:4000`
the image name looks like `172.22.2.81:4000/kollaglue/data`
When user use kolla-ansible,
user set `docker_registry` to `172.22.2.81:4000` in `/etc/kolla/globals.yml`.
Build image using `tools/build.py -n abcd`
the image name looks like `abcd/data`
When user use kolla-ansible,
user set `docker_namespace:` to `abcd` in `/etc/kolla/globals.yml`.
build image using `tools/build.py -n abcd --registry 172.22.2.81:4000`
the image name looks like `abcd/data`
When user use kolla-ansible,
user set `docker_namespace:` to `abcd` in `/etc/kolla/globals.yml`.
user set `docker_registry` to `172.22.2.81:4000` in `/etc/kolla/globals.yml`.
With the feature, it will reduce user confusing and mistaking.
Change-Id: I18ac7a3ccec032888e35f5e9a79fc190760cc8a0
Closes-Bug: #1505056
Reformat local registry section. And document that the Docker config need to
be modified when building images if using local registry.
Change-Id: I51c4df499d84c8ce2a2afc3787b2d609cc0f7d7e
The source location definition previously in build.ini was merged in
etc/kolla/kolla-build.conf since it is really configuration for the
kolla-build tool.
Change-Id: I7531af0029bdfeabbaefb8a6aa97b70bb12c021a
Closes-Bug: #1496702
Kolla build script configuration now lives in
/etc/kolla/kolla-build.conf.
This allows overriding configuration options without the need to pass
arguments on the command line.
Command line arguments still get precedence.
Closes-Bug: #1496185
Change-Id: I69482a11437087f19d7f76b379dca85b1f622268
Add support to the base image for running RHEL containers. Document
how to register a system with RHN in image-buliding.rst.
Change-Id: Id69c114cf734a8242066b8d7d05ba19c07af036a
Partially-Implements: blueprint rhel-based-image-support
The publishing docs expect the documentation to be present in the
/doc directory not the /docs directory. If the documentation is in
the /docs directory, according to fungi the docs won't be published
properly.
Change-Id: I718fec7e69d298a5cb2376ca4e2455e12169566e
Partially-Implements: blueprint kola-tox-doc