doc: Improve OpenStack integration and multitenancy docs for radosgw

[fghaas]

Add explanatory information on:

• rgw swift account in url (including the Swift account in the Swift API url and Keystone endpoint)
• rgw swift versioning enabled (enabling Swift object versioning)
• rgw s3 auth use keystone (enabling S3 authentication against Keystone)
• rgw keystone implicit tenants (multi-tenancy via Keystone, including its implications for the Swift and S3 APIs)

[fghaas]

jenkins render docs

[ceph-jenkins]

Doc render available at http://docs.ceph.com/ceph-prs/25056/

[fghaas]

jenkins render docs

[ceph-jenkins]

Doc render available at http://docs.ceph.com/ceph-prs/25056/

[fghaas]

jenkins render docs

[ceph-jenkins]

Doc render available at http://docs.ceph.com/ceph-prs/25056/

[fghaas]

jenkins render docs

[ceph-jenkins]

Doc render available at http://docs.ceph.com/ceph-prs/25056/

[fghaas]

I should probably mention #15020 here so that GitHub creates a reference between the two. This patch clarifies that X-History-Location is presently not supported for the Swift API; when #15020 lands that documentation would need to be updated in whatever branches #15020 is applied to.

[fghaas]

jenkins render docs

[ceph-jenkins]

Doc render available at http://docs.ceph.com/ceph-prs/25056/

[mattbenjamin]

@fghaas this is a wonderful contribution, thank you

[fghaas]

@mattbenjamin Thanks for the kind words! If you happen to have answers for my questions in http://lists.ceph.com/pipermail/ceph-users-ceph.com/2018-November/031419.html, or know someone who does, I'd be very grateful. Then I'd be able to wrap this up and drop the WIP prefix, so that this is good for final review and merging.

[fghaas]

jenkins render docs

[ceph-jenkins]

Doc render available at http://docs.ceph.com/ceph-prs/25056/

[fghaas]

Does anyone know why we have to specifically coax Jenkins into a publicly consumable doc render, when there's already a docs build check that runs through the whole build?

[fghaas]

jenkins render docs

[LenzGr]

Does anyone know why we have to specifically coax Jenkins into a publicly consumable doc render, when there's already a docs build check that runs through the whole build?

That's actually a good question @fghaas - I wonder if this is something for the ongoing docubetter effort? @neha-ojha - any thoughts on that?

[ceph-jenkins]

Doc render available at http://docs.ceph.com/ceph-prs/25056/

[theanalyst]

afaik, to save server space and reduce garbage collection, we don't render docs automatically for all prs , render docs is more of a utility to see how the output would like for those creating docs prs esp when using more rst features

[fghaas]

[removed (was posted unintentionally)]

[fghaas]

Sorry, fat-fingered the close button there. :(

[ceph-jenkins]

Doc render available at http://docs.ceph.com/ceph-prs/25056/

[fghaas]

Now that the U.S. holiday weekend is over, I would hugely appreciate if someone with approval karma could give this a final review. @mattbenjamin perhaps?

[cbodley]

@rzarzynski could you please help with review?

[mattbenjamin]

@mdw-at-linuxbox can you please contribute a review by, say, 12/10/2018?

[fghaas]

Taking the liberty to poke this again. If everyone's in agreement that this is good to merge then I'd love to see it merged before I tackle my next doc patch (on rbdmirror) — as I would have real trouble juggling two or more pending patches, due to $dayjob.

[yehudasa]

@fghaas see my comment there, otherwise fine.

[yehudasa]

@fghaas note that the rgw_swift_url_prefix here and on other places is missing >

[fghaas]

@yehudasa Thanks! Well spotted. Fixed, amended, and force-pushed. Since this has been in the making for a while now, should I be rebasing on current master?

[fghaas]

CMakeFiles/Makefile2:457: recipe for target 'CMakeFiles/tests.dir/rule' failed
make[1]: *** [CMakeFiles/tests.dir/rule] Error 2
Makefile:251: recipe for target 'tests' failed
make: *** [tests] Error 2
Build step 'Execute shell' marked build as failure
[BFA] Scanning build for known causes...
[BFA] Found failure cause(s):
[BFA] CMake recipe for target failed from category Development
[BFA] Done. 1s
Setting status of d730820a481007207ca4d9870cf3abe3ec407690 to FAILURE with url https://jenkins.ceph.com/job/ceph-pull-requests-arm64/27450/ and message: 'make check failed

Not sure if this has anything to do with my patch?

[yehudasa]

@fghaas internal compiler error: Segmentation fault so probably not related to your patch. More like env issue on the arm machines.

[fghaas]

Thanks for merging, @yehudasa!