[placement][docs][packaging] rpm- and deb- related placement install docs
The placement install docs [1] have the following warning plastered on top: These installation documents are a work in progress. Some of the distribution packages mentioned are not yet available so the instructions will not work. It is likely that packages are now available, but the docs have not been updated to reflect that, nor have the docs been verified against those packages. None of the regular and active contributors to placement are involved with distro-related packaging. In addition they are all already fully booked. Are there members of the community who are involved with the distros, and who can update and verify these docs? If not, we will likely need to remove the distro related install documents before the end of the Train release and solely maintain the install-from-pypi docs [2] (which are up to date). This is because the existing docs are now misleading, and thus potentially dangerous and extra-work-inducing, as suggested by a recent bug [3]. If you are interested in helping out, please follow up. If you're unable to help out, but know people involved with packaging who should know about this concern, please let them know. Thanks for your help. [1] https://docs.openstack.org/placement/latest/install/index.htmlk [2] https://docs.openstack.org/placement/latest/install/from-pypi.html [3] https://storyboard.openstack.org/#!/story/2005910 -- Chris Dent ٩◔̯◔۶ https://anticdent.org/ freenode: cdent
On Wed, 2019-06-19 at 16:57 +0100, Chris Dent wrote:
The placement install docs [1] have the following warning plastered on top:
These installation documents are a work in progress. Some of the distribution packages mentioned are not yet available so the instructions will not work.
It is likely that packages are now available, but the docs have not been updated to reflect that, nor have the docs been verified against those packages.
None of the regular and active contributors to placement are involved with distro-related packaging. In addition they are all already fully booked. Are there members of the community who are involved with the distros, and who can update and verify these docs? from an RPM perspective the validation should like be done with RDO rpms and centos/fedora. aproching this from a product perspective while redhat OSP will contain RPM for placment OSP from 13+ is only supporot if the installation is done via OSP Director (tripleo) which uses docker contaienr that are prebuilt and hosted on a redhat registry
so from a RHEL/OSP pserspectinv direcly inalling placment via the RPM is not a supported way of using of deploying placmenet. that said we will be using the rpm to build the container image so the bits will be identicaly so it should work but for the docs to be useful i think the RPM docs shoudl not refernece rhel or osp and focus just on the cenots/fedora based install and the RDO rpms. assuming we keep the distro docs that is.
If not, we will likely need to remove the distro related install documents before the end of the Train release and solely maintain the install-from-pypi docs [2] (which are up to date). This is because the existing docs are now misleading, and thus potentially dangerous and extra-work-inducing, as suggested by a recent bug [3].
im not really invovled in any of the packaging but in theory placement would fall under the remit of the Compute DFG which im in so ill bring this up internally and see if we can help with this but i also think its perfectly fair to just document the pip/git installation workflow and leave the distor stuff to distors to document downstream if they supprot that.
If you are interested in helping out, please follow up. If you're unable to help out, but know people involved with packaging who should know about this concern, please let them know.
Thanks for your help.
[1] https://docs.openstack.org/placement/latest/install/index.htmlk [2] https://docs.openstack.org/placement/latest/install/from-pypi.html [3] https://storyboard.openstack.org/#!/story/2005910
Hello, On Wed, Jun 19, 2019, at 08:57, Chris Dent wrote:
The placement install docs [1] have the following warning plastered on top:
These installation documents are a work in progress. Some of the distribution packages mentioned are not yet available so the instructions will not work.
It is likely that packages are now available, but the docs have not been updated to reflect that, nor have the docs been verified against those packages.
None of the regular and active contributors to placement are involved with distro-related packaging. In addition they are all already fully booked. Are there members of the community who are involved with the distros, and who can update and verify these docs?
SUSE has packages for Placement now. I've gone ahead and made the adjustments to the docs: https://review.opendev.org/666408 Thanks for pointing it out. Colleen
If not, we will likely need to remove the distro related install documents before the end of the Train release and solely maintain the install-from-pypi docs [2] (which are up to date). This is because the existing docs are now misleading, and thus potentially dangerous and extra-work-inducing, as suggested by a recent bug [3].
If you are interested in helping out, please follow up. If you're unable to help out, but know people involved with packaging who should know about this concern, please let them know.
Thanks for your help.
[1] https://docs.openstack.org/placement/latest/install/index.htmlk [2] https://docs.openstack.org/placement/latest/install/from-pypi.html [3] https://storyboard.openstack.org/#!/story/2005910
-- Chris Dent ٩◔̯◔۶ https://anticdent.org/ freenode: cdent
Hello, The Ubuntu package placement-api is valid from Train, earlier the package was named nova-placement-api so the documentation should be correct for the Train release. When thinking about it; there might be duplicates right now and maybe the nova-placement-api hasn't been removed for Train yet. Best regards Tobias On 06/19/2019 06:00 PM, Chris Dent wrote:
The placement install docs [1] have the following warning plastered on top:
These installation documents are a work in progress. Some of the distribution packages mentioned are not yet available so the instructions will not work.
It is likely that packages are now available, but the docs have not been updated to reflect that, nor have the docs been verified against those packages.
None of the regular and active contributors to placement are involved with distro-related packaging. In addition they are all already fully booked. Are there members of the community who are involved with the distros, and who can update and verify these docs?
If not, we will likely need to remove the distro related install documents before the end of the Train release and solely maintain the install-from-pypi docs [2] (which are up to date). This is because the existing docs are now misleading, and thus potentially dangerous and extra-work-inducing, as suggested by a recent bug [3].
If you are interested in helping out, please follow up. If you're unable to help out, but know people involved with packaging who should know about this concern, please let them know.
Thanks for your help.
[1] https://docs.openstack.org/placement/latest/install/index.htmlk [2] https://docs.openstack.org/placement/latest/install/from-pypi.html [3] https://storyboard.openstack.org/#!/story/2005910
participants (4)
-
Chris Dent
-
Colleen Murphy
-
Sean Mooney
-
Tobias Urdin