Sounds like a problem with one or more packages (perhaps python-glanceclient?) because that command using the source version (not packages) returns the normal list of help items. Maybe try the source version using "pip install python-glanceclient"?
On Sat, Apr 11, 2015 at 5:55 AM, Bernd Bausch <berndbausch at gmail.com> wrote:
glance help image-create. Sorry for being vague.
When running glance with the parameters from the install guide (the trunk version), I am told that I am not doing it correctly; I don’t have the precise message handy.
My fear is that I will hit similar problems later. You solving the problem would be nice but not enough :)
*From:* Matt Kassawara [mailto:mkassawara at gmail.com] *Sent:* Saturday, April 11, 2015 1:59 PM *To:* Bernd Bausch *Cc:* openstack-docs at lists.openstack.org
*Subject:* Re: [OpenStack-docs] [install-guide] RE: What's Up Doc? Apr 10 2015
When you run "glance help image-create" or just "glance image-create" with no arguments?
On Fri, Apr 10, 2015 at 11:45 PM, Bernd Bausch <berndbausch at gmail.com> wrote:
This is what I get when running glance image-create:
usage: glance image-create [--property <key=value>] [--file <FILE>]
[--progress]
<unavailable>
Create a new image.
Positional arguments:
<unavailable> Please run with connection parameters set to retrieve
the schema for generating help for this command
So I wonder how I can get to the bottom of this.
*From:* Matt Kassawara [mailto:mkassawara at gmail.com] *Sent:* Saturday, April 11, 2015 1:39 PM *To:* Bernd Bausch; openstack-docs at lists.openstack.org *Subject:* Re: [OpenStack-docs] [install-guide] RE: What's Up Doc? Apr 10 2015
I'd use the conventional python-*client for all services except keystone because the Openstack client doesn't seem very complete for them. If you're using the glance client, it defaults to the v1 API and the commands from the Juno installation guide should work. If you use the v2 API, one thing changes with how to set public/private visibility.
On Fri, Apr 10, 2015 at 8:11 PM, Bernd Bausch <berndbausch at gmail.com> wrote:
Regarding the installation guide, I need some advice. Perhaps the docs community can help?
I am trying to install Kilo on yum-based systems using a repo from the RDO project. I have hit a few roadblocks that I have been able to deal with, but I am unsure what to do with the current one.
My questions are: Is it appropriate to ask developers about the intended way of doing things, if the old ways don’t work anymore? If yes, what are the best channels – chat, dev mailing list, personal email, …? If no, what else can I do? Do developers make such changes public somewhere?
Below is the problem I am currently trying to solve. **Note** that I am including it as an illustration what I am struggling with (more problems will show up as I continue working on this); I am not asking you to solve this particular problem for me.
So far, to upload an image to Glance, the “glance image-create” command is used. This command doesn’t work anymore as in the past, and I don't understand what the “glance help image-create” is trying to say. On the other hand, I haven’t found an equivalent command in the new “openstack” CLI client. So my question is – what is the correct way to upload an image these days.
Have a great weekend,
Bernd
From: Anne Gentle [mailto:annegentle at justwriteclick.com] Sent: Saturday, April 11, 2015 12:24 AM To: openstack-docs at lists.openstack.org; OpenStack Development Mailing List; openstack-i18n at lists.openstack.org Cc: Jesse Noller Subject: [OpenStack-docs] What's Up Doc? Apr 10 2015
Hi all,
As you probably saw from PTL nominations last week, I'm happy to hand the docs PTL baton to Lana Brindley! I loved leading this group and thank you all for supporting me. Thank you Lana for your willingness to lead. I'm still here to bring us to the Kilo release, so this week's What's Up Doc brings sharp focus requests to everyone to work on docs. These are
priorities that we all need to work on - devs, writers, testers, gaters, everyone.
1. Bug triaging and fixing, especially for openstack-manuals. There are nearly 300 DocImpact bugs logged that we need developers to circle back to. With nearly 600 bugs overall, we need lots of focus here. To that end, I propose we hold a bug triage day. I'll send details in a separate email.
2. Install Guide testing and reviewing. The Install Guide team has a published spec that will help reviewers see what's changing with the Kilo Install guide:
http://specs.openstack.org/openstack/docs-specs/specs/kilo/installguide-kilo...
Join them for weekly meetings Tuesdays at at 13:00 UTC (8:00 AM US CDT) in Google Hangout:
https://plus.google.com/hangouts/_/calendar/a2FyaW4ua2F0aG9kZUBnbWFpbC5jb20....
If you do nothing else but these two focus areas we'll be in good shape. There are other activities going on leading up to Vancouver but those two are top priorities.
_RST Migration_
We are working to resolve translation tool expectations with the i18N team. I want to publish the RST-based English End User Guide and
Admin User
Guide once we're all comfortable with the way forward. Daisy will discuss the implications at the next i18N team meeting Thursday at 0800 UTC, and we'll implement and communicate the plan.
_Networking Guide_
Next on the list is Networking Guide testing and reviewing. The Networking Guide team has a talk in Vancouver and needs to get their guide in shape for publishing. The neutron team is holding a doc day April 23. Please join in -- they'll post details in their notes.
_First App Tutorial_
There's also the First Application Tutorial that needs to finish the spec and needs an editing cleanup prior to publishing. Ideally that will happen before Vancouver, we need to get it to the finish line.
_HA Guide_
With everything else going on we need an updated spec for the HA Guide - the wiki page isn't enough. Based on this week's doc team meeting it sounds like that can go to RST as well but we need it in the spec so we can plan and cross-coordinate with the other priorities leading up to Vancouver.
_Vancouver Summit _ The docs team has four Fishbowl time slots, 2 Workroom slots, and 1 Meetup allocated now. If you'd like to discuss a cross-project idea,
Sorry for top posting - I wasn't subscribed to the doc list before clarkb told me about this thread. Warning ... rage coming ... if you don't want to read rage on a Saturday, I recommend skipping this email. a) There may be a doc bug here, but I'm not 100% convinced it's a doc bug - I'll try to characterize it in this way: "As a user, I do not know what version of glance I am or should be interacting with" That part of this is about the default version that python-glanceclient may or may not use and what version you may or may not need to provide on the command line is a badness I'll get to in a second - but a clear "so you want to upload an image, here's what you need to know" is, I think, what Bernd was looking for b) Glance is categorically broken in all regards related to this topic. This thing is the most painful and most broken of everything that exists in OpenStack. It is the source of MONTHS of development to deal with it in Infra, and even the workarounds are terrible. Let me expand: glance image-upload MAY OR MAY NOT work on your cloud, and there is absolutely no way you as a user can tell. You just have to try and find out. IF glance image-upload does not work for you, it may be because of two things, neither of which are possible for you as a user to find out: Either: - Your cloud has decided to not enable image upload permissions in their policy.json file, which is a completely opaque choice that you as a user have no way of finding out. If this is the case you have no recourse, sorry. - Your cloud has deployed a recent glance and has configured it for glance v2 and has configured it in the policy.json file to ONLY allow v2 and to disallow image-upload If the second is true, which you have no way to discover except for trying, what you need to do is: - upload the image to swift - glance task-create --type=import --input='{"import_from": "$PATH_TO_IMAGE_IN_SWIFT", "image_properties" : {"name": "Human Readable Image Name"}}' Yes, you do have to pass JSON on the command line, because BONGHITS (/me glares at the now absent Brian Waldon with withering disdain for having inflicted such an absolutely craptastic API on the world.) Then, you need to poll glance task-status for the status of the import_from task until your image has imported. c) The python-glanceclient command line client should encapsulate that ridiculous logic for you, but it does not d) It should be possible to discover from the cloud which of the approaches you should take, but it isn't Now - I'm honestly not sure how far the docs team should take working around this - because fully describing how to successfully upload an image without resorting to calling people names is impossible - but is it really the Docs team job to make an impossible API seem user friendly? Or, should we not treat this as a docs bug and instead treat it as a Glance bug and demand a v3 API that rolls back the task interface? I vote for the latter. BTW - the shade library encodes as much of the logic above as it can. That it exists makes me sad. Monty On Sat, Apr 11, 2015 at 10:50 AM, Matt Kassawara <mkassawara at gmail.com> wrote: the top please
use the form to suggest new ideas: http://goo.gl/forms/S69HM6XEeb. You can see the current suggestions already posted here:
https://docs.google.com/spreadsheets/d/1vCTZBJKCMZ2xBhglnuK3ciKo3E8UMFo5S5lm...
Lana or I will send out an etherpad in the next week or so with topic suggestions for our allocation.
Thanks, Anne
-- Anne Gentle annegentle at justwriteclick.com
_______________________________________________ OpenStack-docs mailing list OpenStack-docs at lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
_______________________________________________ OpenStack-docs mailing list OpenStack-docs at lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs