brooklyn-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mikezaccardo <...@git.apache.org>
Subject [GitHub] brooklyn-docs pull request #81: Expand OpenStack location docs
Date Mon, 27 Jun 2016 18:25:29 GMT
Github user mikezaccardo commented on a diff in the pull request:

    https://github.com/apache/brooklyn-docs/pull/81#discussion_r68629570
  
    --- Diff: guide/ops/locations/_more-clouds.md ---
    @@ -300,7 +306,124 @@ Configuration of floating IPs is as networks; specify the pools
to use as anothe
               - "pool name"
     
     
    +### Basic Location Structure
    +
    +This is a basic inline YAML template for an OpenStack location:
    +
    +```
    +location:
    +  jclouds:clouds:openstack-nova:
    +    endpoint: http://x.x.x.x:5000/v2.0/
    +    identity: "your-tenant:your-username"
    +    credential: your-password
    +
    +    # imageId, hardwareId, and loginUser* are optional
    +    imageId: your-region-name/your-image-id
    +    hardwareId: your-region-name/your-flavor-id
    +    loginUser: 'ubuntu'
    +    loginUser.privateKeyFile: /path/to/your/privatekey
    +
    +    jclouds.openstack-nova.auto-generate-keypairs: false
    +    jclouds.openstack-nova.auto-create-floating-ips: true
    +
    +    templateOptions:
    +      networks: [ "your-network-id" ]
    +      floatingIpPoolNames: [ "your-floatingIp-pool" ]
    +      securityGroups: ['your-security-group']
    +
    +      # Optional if 'jclouds.openstack-nova.auto-generate-keypairs' is assigned to 'true'
    +      keyPairName: "your-keypair"
    +```
    +
    +This is the same OpenStack location in a format that can be added to your
    +`brooklyn.properties` file:
    +
    +```
    +brooklyn.location.named.My\ Openstack=jclouds:openstack-nova:http://x.x.x.x:5000/v2.0/
    +brooklyn.location.named.My\ OpenStack.identity=your-tenant:your-username
    +brooklyn.location.named.My\ OpenStack.credential=your-password
    +brooklyn.location.named.My\ OpenStack.endpoint=http://x.x.x.x:5000/v2.0/
    +
    +brooklyn.location.named.My\ OpenStack.imageId=your-region-name/your-image-id
    +brooklyn.location.named.My\ OpenStack.hardwareId=your-region-name/your-flavor-id
    +brooklyn.location.named.My\ OpenStack.loginUser=ubuntu
    +brooklyn.location.named.My\ OpenStack.loginUser.privateKeyFile=/path/to/your/privatekey
    +brooklyn.location.named.My\ OpenStack.openstack-nova.auto-generate-keypairs=false
    +brooklyn.location.named.My\ OpenStack.openstack-nova.auto-create-floating-ips=true
    +
    +brooklyn.location.named.My\ OpenStack.networks=your-network-id
    +brooklyn.location.named.My\ OpenStack.floatingIpPoolNames=your-floatingIp-pool
    +brooklyn.location.named.My\ OpenStack.securityGroups=your-security-group
    +brooklyn.location.named.My\ OpenStack.keyPair=your-keypair
    +```
    +
    +Chose a value of `your-flavor-id` from one of the defaults, or create your own flavor
if
    +you have administrator privileges.
    +For for more information, see the
    +[OpenStack flavors guide](http://docs.openstack.org/admin-guide/cli_manage_flavors.html).
    +
    +The default flavors are:
    +
    +```
    ++-----+-----------+-----------+------+
    +| ID  | Name      | Memory_MB | Disk |
    ++-----+-----------+-----------+------+
    +| 1   | m1.tiny   | 512       | 1    |
    +| 2   | m1.small  | 2048      | 20   |
    +| 3   | m1.medium | 4096      | 40   |
    +| 4   | m1.large  | 8192      | 80   |
    +| 5   | m1.xlarge | 16384     | 160  |
    ++-----+-----------+-----------+------+
    +```
    +
    +For an even more detailed example location configuration, consult the
    +[template properties file](https://brooklyn.apache.org/v/latest/start/brooklyn.properties).
    +
    +
     ### Other features
     
     Consult jclouds' [Nova template options](https://jclouds.apache.org/reference/javadoc/1.9.x/org/jclouds/openstack/nova/v2_0/compute/options/NovaTemplateOptions.html)
     for futher options when configuring Openstack locations.
    +
    +### Troubleshooting
    +
    +#### jclouds Namespace Issue
    +
    +A change to Nova's API resulted in all extensions having the same "fake" namespace which
    +the current version of jclouds does not yet support.
    +
    +If you are having problems deploying to OpenStack, consult your Brooklyn debug log and
    +look for the following:
    +
    +```
    +"namespace": "http://docs.openstack.org/compute/ext/fake_xml"
    +```
    +
    +If this appears, perform the following steps as a workaround:
    +
    +* Generate a patch JAR `openstack-devtest-compute-1.9.2.jar`
    --- End diff --
    
    Is this JAR hosted somewhere?  Probably better to offer a download link vs. asking users
to build it themselves.


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

Mime
View raw message