Commit Graph

47 Commits

Author SHA1 Message Date
Tadas Sutkaitis 3ee1a82d87 add: cross-compile support
The main goal is to be able to build ARM
images on standard x86 hardware. Add simple
functions supported by python-py and
podman-py to enable creation of container
images on emulated architectures.

Change-Id: I1526b460f6e271c2ec63ab3a3b1dc348d742e96d
2024-02-08 02:16:05 +02:00
Sven Kieske db0a389945
[docs] add instructions for optional dependencies
Change-Id: Iac6617a6755a8271f1cd423c50e79a82bc75e67b
Signed-off-by: Sven Kieske <kieske@osism.tech>
2023-09-21 14:42:26 +02:00
Jason d079dd67e3 Add locals_base option
This option allows you to define 'locals' style dependencies as relative
to a $locals_base variable, similar to how $tarballs_base works. This
can help you avoid defining the same hard-coded path in kolla-build, and
instead pass it to kolla via a flag.

Similar to $tarballs_base, this works via oslo_config's existing
interpolation functionality[1].

Example usage:
  [DEFAULT]
  locals_base = /opt/openstack

  [neutron-base]
  type = local
  location = $locals_base/neutron/neutron-stable-rocky.tar.gz

[1]:
https://docs.openstack.org/oslo.config/latest/reference/configuration-files.html#option-value-interpolation

Change-Id: I8670db4dde4dac26df28502637eadc6b854261cf
2023-01-02 08:52:02 +01:00
Marcin Juszkiewicz 8a5922fd71 doc: get rid of remainders of binary images
We still documented some of binary images details. While we do not have
them anymore.

Change-Id: I49148ed788cd35ed9f5606d8b69c5e75230433f3
2022-06-02 12:03:29 +02:00
Zuul 0312ee67ee Merge "Add enabled flag for sources" 2022-03-17 10:44:32 +00:00
Mark Goddard c9f93c30c1 Add enabled flag for sources
Sometimes it might be useful to disable a source for an image, e.g. for
a plugin that is not used. This may be to reduce image sizes, or
restrict the dependencies necessary to build images.

This change adds a new 'enabled' option to each source definition. This
allows sources, plugins or additions for each source image to be
disabled individually.

Change-Id: I31ee0744574fb3db96bee2e9f545600de53d9ee4
2022-03-16 17:07:01 +00:00
Maksim Malchuk 83efe32546 Unify curl use (customisation options)
This change adds and unifies an ability to override hardcoded URLs for
air-gapped environments via the usual blocks mechanism. Also, this
change replaces ENV with ARG instruction for the variables used only
in building images, and uses bash variable expansion where it possible.

This change is a continuation of the I46b77978926fc2b578a68d1aaa944b2198af0685

Change-Id: I1fbad333b1bc95484e6f4c5145d5936a0e2db84f
Signed-off-by: Maksim Malchuk <maksim.malchuk@gmail.com>
2022-03-11 15:58:05 +03:00
Victor Coutellier 3fe7df37c0 Clarify documentation about source override
The current documentation about source override is ambiguous and let
users presume that you should always use "-base" after the project name
you want to override source location.

This assumption is wrong, as kolla look for a section who match exactly
the name of the image. Images who don't have a "-base", like Horizon,
are really hard to override for a user.

I propose to put an example without a "-base" and also add a disclaimer
in the documentation about that.

Change-Id: I308a352975f11c29afb3f2ea1c22212062066b4b
2022-03-07 16:43:21 +01:00
Marcin Juszkiewicz dc683fa1cc document that binary images are now deprecated
Support for binary images gets removed in Z cycle.

Change-Id: I9cd93a2022d6b9d17f326d55d57f86cb5e141e7d
2021-11-28 11:06:14 +01:00
Mark Goddard e4f019a5dd Build source type images by default
Source images get the most test coverage, so it makes sense to build
these by default.

Change-Id: Ie10a41a94af95075a1b91feb2b74ade02b17117e
2021-09-30 09:07:10 +01:00
Marcin Juszkiewicz bd90b02708 drop leftovers of RHEL support
As a project we never built RHEL based images so support for them
was not tested.

Change-Id: I27dfe34ade088228d71f6857ec4f3ab28ee63915
2021-07-28 16:04:21 +00:00
Mark Goddard b69240ca4b docs: update supported OS distros
* correct base container image info
* show RHEL as deprecated

Change-Id: Ie8eec4cb4e29e7f659228e2792c13c01dfb4a41c
2021-04-30 17:52:56 +01:00
Radosław Piliszek 02582d9dd5 [release] Add docs on Neutron plugins
And improve the reno.

Change-Id: I76ffed7332da18c8c01e96dbf0c30badf231a0d0
2021-04-21 11:28:15 +00:00
Radosław Piliszek d9efe9cac6 Improve docs
Part of changes discussed during Kolla Kalls.
These make our documentation easier to digest.

Changes in conf.py are to avoid warnings from sphinx.

Change-Id: I76ab6786b271963252278fcf12f1a28cab520fdb
2021-03-17 10:14:51 +00:00
Marcin Juszkiewicz c186122376 docs: drop Fedora info, mark Ubuntu one as Debian / Ubuntu
Newton release was long time ago. Time to retire info that we had Fedora
support.

Change-Id: I44fcb6e11b729369b5e64bdeb64e9ca7c0142979
2021-01-18 12:27:00 +00:00
LinPeiWen 963d4c1366 Update the'image-building.rst' document
The openstack Ussuri and Victoria versions no longer support
python2 and python-pip packages by default,
update the'image-building.rst' document

Change-Id: I34a2880a06e80ec1b7737ec1ffbef5f6ba7bed47
2020-11-30 02:08:42 +00:00
Mark Goddard 7889782113 CentOS 8: Switch last mentions of yum to dnf
Change-Id: I31e9742793cfb1abff9749083c9ce86000dae1af
Partially-Implements: blueprint centos-rhel-8
2020-04-15 14:17:40 +01:00
Mark Goddard 9c1434cf4e Add docs and release note for CentOS 8
Adds info on supported distros to support matrix. Adds release note
about CentOS 7 drop and dropped images.

Change-Id: I0ada13af2fe57de550c1703d636436190e5d489a
Partially-Implements: blueprint centos-rhel-8
2020-04-06 17:37:05 +01:00
Radosław Piliszek 69e05d2b80 Docs: Remove a bad recommendation
Change-Id: I50bea7e81955299949d7129adb8ad70c33decf51
2019-10-29 08:38:27 +01:00
Mark Goddard fa8e174be6 Remove support for OracleLinux
We have agreed to remove support for Oracle Linux.

http://lists.openstack.org/pipermail/openstack-discuss/2019-June/006896.html

Change-Id: I961dfba1aeef2c509ecdaf376dfe6928926ffb39
Depends-On: https://review.opendev.org/682858
2019-09-18 13:42:47 +01:00
Zuul c4c91e4fe8 Merge "Change port of docker registry" 2019-07-05 09:17:19 +00:00
pengdake b5c655e787 Change port of docker registry
The port of docker registry is conflict with keystone.
So we need to change port of docker registry.

Change-Id: If15c0caf76b5406f590b05030e43d65ca14c8788
Signed-off-by: pengdake <19921207pq@gmail.com>
2019-06-17 14:01:44 +02:00
chenxing ae1e2e6808 doc: Start using openstackdoctheme's extlink extension
This ensures we have version-specific references to other projects [1].
Note that this doesn't mean the URLs are actually valid - we need to do
more work (linkcheck?) here, but it's an improvement nonetheless.

[1] https://docs.openstack.org/openstackdocstheme/latest/#external-link-helper

Change-Id: I7c979dacd89ebead404b751d596ba120b38f00f3
2019-06-14 21:23:10 +08:00
ZhongShengping 4fc5f1cc6e Move to opendev
1.Use opendev.org instead of git.openstack.org.
2.Use review.opendev.org instead of review.openstack.org.

You can see the discussion below:
http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html

Change-Id: I377ea63827b6f3995ee275fdc466c1b2100eafc7
2019-04-24 15:22:57 +08:00
Alex Schultz 3e5d8e2653 Add python3 packages for RHEL systems
RDO is currently working on python3 support for the next version of
CentOS/RHEL based systems.  This package uses the distro_python3 flag
that was added as part of I4028991bad92c0e8e21066cc4173c06ce5eba393 to
use the python3 specific package names.  This change only adds python3
package names for RHEL systems.

Conflicts-With: https://review.openstack.org/#/c/636457/
Change-Id: Iad6b70b433a0dd1b0f8ae6790fd280594517661a
Related-Blueprint: python3-support
2019-03-12 17:48:18 +00:00
zhouxinyong 67448358bf Replacing the HTTP protocal with HTTPS .
Change-Id: I4217433a2c7d199a3768ae02e2f6798fe6703fd8
2018-11-14 09:41:51 +00:00
Zuul 7776b44cec Merge "Fix documentation for Kolla image-building guide" 2018-11-08 10:01:30 +00:00
letrangg 36d3c5b232 Fix documentation for Kolla image-building guide
A grammar error that might make it confusing for the readers
to follow the document was fixed.

Change-Id: I497822904d1360f64ef3fbaf9c128fcb38e2f8db
2018-11-08 11:12:05 +07:00
chenxing 43e9021648 Remove '.. end' comments
Following by https://review.openstack.org/#/c/605097/
These were used by now-dead tooling. We can remove them.

Change-Id: I790a18b3a40c22ec94bc6f6dba656ba4db518cfe
2018-09-28 10:01:05 +08:00
Andreas Jaeger 41720b51b1 Fix doc8 failures
The new openstack-tox-docs fails the doc8 test due to overlong lines.
Wrap them around.

Change-Id: I335be7fc37302d86d6b8d8182188623aa91542ba
Needed-By: https://review.openstack.org/595412
2018-08-31 09:28:23 +02:00
chengebj5238 a745e71bf8 Amend the spelling error of a word
Change-Id: Ic961dde88fb89a0053f155b17b2261c005a21ea6
2018-06-06 17:12:52 +08:00
Zuul 27381101bc Merge "Clarify how to generate kolla-build.conf in docs" 2018-05-04 04:48:12 +00:00
David Rabel 6f441ccd1b Clarify how to generate kolla-build.conf in docs
image-building.rst does not mention where to find the
necessary files to generate kolla-build.conf with tox.

This patch clarifies that you need to check out the git
repository first and also that it is technically not
necessary to generate the kolla-build.conf file.

Change-Id: Ifd6ed216e5086b935ca399b1613319d67424d5ae
Closes-Bug: #1744453
2018-05-03 14:32:56 +00:00
ZhijunWei 697d6f8c38 Update container to image for image-build docs
the kolla-build build image, rather than container,
this ps to fix it.

Change-Id: I2cf423fca9532ac4306dd31253f0c1956ba5d537
2018-05-03 14:31:11 +00:00
ZhijunWei e9f6e4cf8c Add debian into available distros for image building
the debian is supported for image build[0], but the docs missing
it, the ps to add it.

[0]: https://github.com/openstack/kolla/blob/master/kolla/common/config.py#L22

Change-Id: I4bbdb1a607566b4853c6767fca6401cc78576e95
2018-04-30 07:46:35 +00:00
Zuul 8b4b5edd76 Merge "Prompt user that kolla should be installed" 2018-04-19 23:46:59 +00:00
sharyhua d0e2bbb83c Prompt user that kolla should be installed
This patch prompts user that kolla should be installed before running
`kolla-build` command.

Change-Id: I731d8c2e991bf1bc1bace99defcd463a135e3340
2018-04-16 07:05:39 +00:00
Nguyen Hai 850bd8afaf Follow the new PTI for document build
For compliance with the Project Testing Interface as described in:
[1] https://governance.openstack.org/tc/reference/project-testing-interface.html
[2] http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html

Change-Id: I302aced3b50b038900375e9632ca7ed136f32914
2018-03-16 03:32:55 +09:00
Zuul 9735112313 Merge "Add one more step to generate kolla-build.conf file" 2018-02-13 15:13:33 +00:00
Zuul 30b45348cb Merge "Added more information on building images" 2018-02-05 18:50:30 +00:00
Anh3h 4ae790313b Added more information on building images
Added more information for building images on developement enviroment by
adding location to the build file for each kolla-build and location to
docker files for each image

Partially-Implements: https://blueprints.launchpad.net/kolla/+spec/queens-doc-restructure
Change-Id: I1d074070e76952ff7e015fed4b7c4dd81db228ac
2018-02-03 23:08:37 +01:00
caoyuan cb2266db34 Update "containers" to "images"
the kolla-build is used to build images, rather than
containers

Change-Id: Ia9e23835a022c01224268f565997e979b0b9d812
2018-01-30 12:58:45 +08:00
chenxing b8d8c21f88 Add one more step to generate kolla-build.conf file
Change-Id: Ieaa516c8f18d42d0a8fd3f65ad6cf0b88d9c49ef
Closes-Bug: #1744453
2018-01-29 15:02:54 +08:00
chenxing ce0555d172 Upgrade the rst convention of the Admin Guide
We upgrade the rst convention by following Documentation Contributor
Guide[1].

[1] https://docs.openstack.org/doc-contrib-guide/rst-conv/

Change-Id: Iad2664f1797b4c48dacc49502f9213b7ff849d34
Implements: blueprint optimize-the-documentation-format
2017-11-21 10:49:05 +08:00
Surya Prakash Singh e5ad31e6fe Fixes the Deploy Registry link
Change-Id: I9f7d71d404eaeafc33f8c390ca8e74eadeabf4f4
2017-11-07 17:05:23 +05:30
33519XuLei bdb26e266a fix local_registry url link error
Change-Id: I0f2e8039fc769a08fa5368ae4ca388015ce34124
2017-10-19 11:01:17 +08:00
chenxing 5493fb64e1 Rearrange existing documentation to fit the new standard layout
For more detail, see the doc migration spec.
http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html

Partially-Implements: blueprint queens-doc-restructure

Co-Authored-By: Kurt Taylor <kurt.r.taylor@gmail.com>
Change-Id: Iab93bf023a13b953a31152b91d4fea0fa75bf2d0
2017-10-11 14:06:08 +08:00