brooklyn-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From geomacy <...@git.apache.org>
Subject [GitHub] brooklyn-docs pull request #159: Add docs for enricher.producer values
Date Thu, 30 Mar 2017 09:05:34 GMT
Github user geomacy commented on a diff in the pull request:

    https://github.com/apache/brooklyn-docs/pull/159#discussion_r108867638
  
    --- Diff: guide/dev/tips/index.md ---
    @@ -39,21 +39,32 @@ title: Miscellaneous Tips and Tricks
       sensors and config keys can be re-used.
       (Many are inherited from interfaces, where they are declared as constants,
       e.g. ``Attributes`` and ``UsesJmx``.)
    -  
    +
     * Understand the location hierarchy:  software process entities typically get an ``SshMachineLocation``,
       and use a ``*SshDriver`` to do what they need.  This will usually have a ``MachineProvisioningLocation``
parent, e.g. a
       ``JcloudsLocation`` (e.g. AWS eu-west-1 with credentials) or possibly a ``LocalhostMachineProvisioningLocation``.
       Clusters will take such a ``MachineProvisioningLocation`` (or a singleton list); fabircs
take a list of locations.
       Some PaaS systems have their own location model, such as ``OpenShiftLocation``.
     
    -Finally, don't be shy about [talking with others]({{site.path.website}}/community/),

    -that's far better than spinning your wheels (or worse, having a bad experience),
    -plus it means we can hopefully improve things for other people!
    +* Finally, don't be shy about [talking with others]({{site.path.website}}/community/),
    +  that's far better than spinning your wheels (or worse, having a bad experience),
    +  plus it means we can hopefully improve things for other people!
     
    +## YAML Blueprint Debugging
    +
    +* Brooklyn will reject any YAML blueprint that contains syntax errors and will alert
the user of such errors.
    +
    +* However, it is possible to create a blueprint that is syntactically legal but results
in runtime problems
    +  for Brooklyn (for example, if an enricher's `enricher.producer` value is not immediately
resolvable).
    +
    +* If Brooklyn misbehaves or freezes after deploying a blueprint, run the `jstack <brooklyn-pid>`
command to view
    --- End diff --
    
    I wouldn't use 'misbehaves' here.  How about just "If Brooklyn appears to freeze"?


---
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