You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@brooklyn.apache.org by sjcorbett <gi...@git.apache.org> on 2016/12/01 11:32:44 UTC
[GitHub] brooklyn-docs pull request #128: 0.10.0 release notes
GitHub user sjcorbett opened a pull request:
https://github.com/apache/brooklyn-docs/pull/128
0.10.0 release notes
Phew!
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/sjcorbett/brooklyn-docs release-notes
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/brooklyn-docs/pull/128.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #128
----
commit 824f1958a8723a719203036170b0d5513694e957
Author: Sam Corbett <sa...@cloudsoftcorp.com>
Date: 2016-12-01T11:32:27Z
0.10.0 release notes
----
---
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.
---
[GitHub] brooklyn-docs pull request #128: 0.10.0 release notes
Posted by neykov <gi...@git.apache.org>.
Github user neykov commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/128#discussion_r90651670
--- Diff: guide/misc/release-notes.md ---
@@ -14,15 +14,121 @@ to Brooklyn's commercial users for funding much of this development.
### New Features
+#### Improved Blueprints
+
+Significant work has gone into making YAML blueprints more powerful.
+The DSL is more expressive and a variety of new general-purpose entities,
+enrichers and policies have been written.
+
+New general-purpose constructs:
+
+* The `InvokeEffectorOnSensorChange` and `InvokeEffectorOnCollectionSensorChange`
+ policies execute effectors on entities whenever a target sensor changes.
+* `ProxyEffector` forwards effector invocations from one entity to another.
+* `ConditionalEntity` creates an entity based on the truth of a config key
+ (e.g. `$brooklyn:scopeRoot().config("enable.loadBalancer")`).
+* `OnPublicNetworkEnricher` grants finer control of mapping public
+ and private network addresses to sensors.
+* `PercentageEnricher` publishes the ratio of two sensors.
+
+New blueprint DSL features:
+
+* `$brooklyn:entity` supports nested function calls,
+* `$brookln:getImmediately` resolves values immediately and throws if it cannot,
--- End diff --
That's not a user-facing feature, not meant to be called by user DSL.
---
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.
---
[GitHub] brooklyn-docs issue #128: 0.10.0 release notes
Posted by sjcorbett <gi...@git.apache.org>.
Github user sjcorbett commented on the issue:
https://github.com/apache/brooklyn-docs/pull/128
P.S. I put together a really quick script for retrieving the PRs that were merged into brooklyn-server that may be useful the next time someone wants to write release notes: https://gist.github.com/sjcorbett/72ed944b06ce3a138fbe516e8d36f624.
---
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.
---
[GitHub] brooklyn-docs pull request #128: 0.10.0 release notes
Posted by sjcorbett <gi...@git.apache.org>.
Github user sjcorbett commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/128#discussion_r90431884
--- Diff: guide/misc/release-notes.md ---
@@ -14,15 +14,121 @@ to Brooklyn's commercial users for funding much of this development.
### New Features
+#### Improved Blueprints
+
+Significant work has gone into making YAML blueprints more powerful.
+The DSL is more expressive and a variety of new general-purpose entities,
+enrichers and policies have been written.
+
+New general-purpose constructs:
+
+* The `InvokeEffectorOnSensorChange` and `InvokeEffectorOnCollectionSensorChange`
+ policies execute effectors on entities whenever a target sensor changes.
+* `ProxyEffector` forwards effector invocations from one entity to another.
+* `ConditionalEntity` creates an entity based on the truth of a config key
+ (e.g. `$brooklyn:scopeRoot().config("enable.loadBalancer")`).
+* `OnPublicNetworkEnricher` grants finer control of mapping public
+ and private network addresses to sensors.
+* `PercentageEnricher` publishes the ratio of two sensors.
+
+New blueprint DSL features:
+
+* `$brooklyn:entity` supports nested function calls,
+* `$brookln:getImmediately` resolves values immediately and throws if it cannot,
+* `$brooklyn:object` supports parameterised constructors and static factory methods, hugely increasing the range of objects that can be injected into entities,
+* `$brooklyn:entityId` returns the target entity's ID, and
+* `$brooklyn:self` accesses the resolving task's context entity.
+
+
+#### Bundled entities
+
+There have been many updates to the entities bundled with Brooklyn. In particular:
+
+* `DynamicCluster` allows configuration of member removal strategies.
+* The `Transformer` enricher can be triggered by events on multiple sensors.
+* `ZooKeeperNode` publishes main.uri and `ZooKeeperEnsemble` aggregates
+ hosts and ports into comma-separated list under `zookeeper.endpoints`.
+* `BindDnsServer` listens on all interfaces and supports Centos and RHEL.
+* `NginxController` supports proxying with TLS client certificates.
+* `RiakNode` optionally configures security groups for intra-node communication
+ when supported by the target cloud.
+* `PostgreSqlNode` can be configured to grant [user roles](https://www.postgresql.org/docs/9.3/static/role-membership.html).
+* `SharedLocationSecurityGroupCustomizer` enables security group
+ configuration in yaml blueprints.
+* Feeds no longer poll if their entity is unmanaged.
+
+Several new test-case entities are introduced:
+
+* `TestHttpCall` [supports](https://github.com/apache/brooklyn-server/pull/414) a greatly expanded range of options.
+* `TestEndpointReachable` tests that a TCP endpoint can be reached.
+* `TestWinrmCommand` tests the success of commands in Windows instances.
+* `RelativeEntityTestCase` lets you write test cases that resolve their target from another entity.
+
+Additionally, location customisers can now be attached to entities as
+initialisers, rather than having to dig into their `templateOptions`.
+
+
+#### Brooklyn server
+
+* The REST API requires CSRF headers for non-GET and HEAD requests when
+ sessions are in effect.
+ See [CsrfTokenFilter](https://brooklyn.apache.org/v/0.10.0/misc/javadoc/org/apache/brooklyn/rest/filter/CsrfTokenFilter.html)
+ for details.
+
+* The catalogue scanner can be configured with whitelists and blacklists
+ of bundle IDs to control which bundles may present applications in the catalogue.
+
+* The Karaf distribution includes equivalents of the
+ [cloud explorer commands](https://brooklyn.apache.org/v/0.10.0/ops/server-cli-reference.html#cloud-explorer).
--- End diff --
I'm assuming this URL will exist too.
---
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.
---
[GitHub] brooklyn-docs issue #128: 0.10.0 release notes
Posted by neykov <gi...@git.apache.org>.
Github user neykov commented on the issue:
https://github.com/apache/brooklyn-docs/pull/128
Thanks @sjcorbett. I've merged this in the [0.10.0 branch](https://github.com/apache/brooklyn-docs/commits/0.10.0). Can you close the PR.
---
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.
---
[GitHub] brooklyn-docs issue #128: 0.10.0 release notes
Posted by neykov <gi...@git.apache.org>.
Github user neykov commented on the issue:
https://github.com/apache/brooklyn-docs/pull/128
Awesome work @sjcorbett. Some minor comments - see what you think, then good to merge.
---
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.
---
[GitHub] brooklyn-docs issue #128: 0.10.0 release notes
Posted by sjcorbett <gi...@git.apache.org>.
Github user sjcorbett commented on the issue:
https://github.com/apache/brooklyn-docs/pull/128
@neykov thanks for checking. I've removed the reference to `getImmediately`.
---
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.
---
[GitHub] brooklyn-docs pull request #128: 0.10.0 release notes
Posted by sjcorbett <gi...@git.apache.org>.
Github user sjcorbett commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/128#discussion_r90912906
--- Diff: guide/misc/release-notes.md ---
@@ -14,15 +14,121 @@ to Brooklyn's commercial users for funding much of this development.
### New Features
+#### Improved Blueprints
+
+Significant work has gone into making YAML blueprints more powerful.
+The DSL is more expressive and a variety of new general-purpose entities,
+enrichers and policies have been written.
+
+New general-purpose constructs:
+
+* The `InvokeEffectorOnSensorChange` and `InvokeEffectorOnCollectionSensorChange`
+ policies execute effectors on entities whenever a target sensor changes.
+* `ProxyEffector` forwards effector invocations from one entity to another.
+* `ConditionalEntity` creates an entity based on the truth of a config key
+ (e.g. `$brooklyn:scopeRoot().config("enable.loadBalancer")`).
+* `OnPublicNetworkEnricher` grants finer control of mapping public
+ and private network addresses to sensors.
+* `PercentageEnricher` publishes the ratio of two sensors.
+
+New blueprint DSL features:
+
+* `$brooklyn:entity` supports nested function calls,
+* `$brookln:getImmediately` resolves values immediately and throws if it cannot,
+* `$brooklyn:object` supports parameterised constructors and static factory methods, hugely increasing the range of objects that can be injected into entities,
+* `$brooklyn:entityId` returns the target entity's ID, and
+* `$brooklyn:self` accesses the resolving task's context entity.
+
+
+#### Bundled entities
+
+There have been many updates to the entities bundled with Brooklyn. In particular:
+
+* `DynamicCluster` allows configuration of member removal strategies.
+* The `Transformer` enricher can be triggered by events on multiple sensors.
+* `ZooKeeperNode` publishes main.uri and `ZooKeeperEnsemble` aggregates
+ hosts and ports into comma-separated list under `zookeeper.endpoints`.
+* `BindDnsServer` listens on all interfaces and supports Centos and RHEL.
+* `NginxController` supports proxying with TLS client certificates.
+* `RiakNode` optionally configures security groups for intra-node communication
+ when supported by the target cloud.
+* `PostgreSqlNode` can be configured to grant [user roles](https://www.postgresql.org/docs/9.3/static/role-membership.html).
+* `SharedLocationSecurityGroupCustomizer` enables security group
+ configuration in yaml blueprints.
+* Feeds no longer poll if their entity is unmanaged.
+
+Several new test-case entities are introduced:
+
+* `TestHttpCall` [supports](https://github.com/apache/brooklyn-server/pull/414) a greatly expanded range of options.
+* `TestEndpointReachable` tests that a TCP endpoint can be reached.
+* `TestWinrmCommand` tests the success of commands in Windows instances.
+* `RelativeEntityTestCase` lets you write test cases that resolve their target from another entity.
+
+Additionally, location customisers can now be attached to entities as
+initialisers, rather than having to dig into their `templateOptions`.
+
+
+#### Brooklyn server
+
+* The REST API requires CSRF headers for non-GET and HEAD requests when
+ sessions are in effect.
+ See [CsrfTokenFilter](https://brooklyn.apache.org/v/0.10.0/misc/javadoc/org/apache/brooklyn/rest/filter/CsrfTokenFilter.html)
+ for details.
+
+* The catalogue scanner can be configured with whitelists and blacklists
+ of bundle IDs to control which bundles may present applications in the catalogue.
+
+* The Karaf distribution includes equivalents of the
+ [cloud explorer commands](https://brooklyn.apache.org/v/0.10.0/ops/server-cli-reference.html#cloud-explorer).
--- End diff --
Got you.
---
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.
---
[GitHub] brooklyn-docs pull request #128: 0.10.0 release notes
Posted by neykov <gi...@git.apache.org>.
Github user neykov commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/128#discussion_r90896340
--- Diff: guide/misc/release-notes.md ---
@@ -14,15 +14,121 @@ to Brooklyn's commercial users for funding much of this development.
### New Features
+#### Improved Blueprints
+
+Significant work has gone into making YAML blueprints more powerful.
+The DSL is more expressive and a variety of new general-purpose entities,
+enrichers and policies have been written.
+
+New general-purpose constructs:
+
+* The `InvokeEffectorOnSensorChange` and `InvokeEffectorOnCollectionSensorChange`
+ policies execute effectors on entities whenever a target sensor changes.
+* `ProxyEffector` forwards effector invocations from one entity to another.
+* `ConditionalEntity` creates an entity based on the truth of a config key
+ (e.g. `$brooklyn:scopeRoot().config("enable.loadBalancer")`).
+* `OnPublicNetworkEnricher` grants finer control of mapping public
+ and private network addresses to sensors.
+* `PercentageEnricher` publishes the ratio of two sensors.
+
+New blueprint DSL features:
+
+* `$brooklyn:entity` supports nested function calls,
+* `$brookln:getImmediately` resolves values immediately and throws if it cannot,
+* `$brooklyn:object` supports parameterised constructors and static factory methods, hugely increasing the range of objects that can be injected into entities,
+* `$brooklyn:entityId` returns the target entity's ID, and
+* `$brooklyn:self` accesses the resolving task's context entity.
+
+
+#### Bundled entities
+
+There have been many updates to the entities bundled with Brooklyn. In particular:
+
+* `DynamicCluster` allows configuration of member removal strategies.
+* The `Transformer` enricher can be triggered by events on multiple sensors.
+* `ZooKeeperNode` publishes main.uri and `ZooKeeperEnsemble` aggregates
+ hosts and ports into comma-separated list under `zookeeper.endpoints`.
+* `BindDnsServer` listens on all interfaces and supports Centos and RHEL.
+* `NginxController` supports proxying with TLS client certificates.
+* `RiakNode` optionally configures security groups for intra-node communication
+ when supported by the target cloud.
+* `PostgreSqlNode` can be configured to grant [user roles](https://www.postgresql.org/docs/9.3/static/role-membership.html).
+* `SharedLocationSecurityGroupCustomizer` enables security group
+ configuration in yaml blueprints.
+* Feeds no longer poll if their entity is unmanaged.
+
+Several new test-case entities are introduced:
+
+* `TestHttpCall` [supports](https://github.com/apache/brooklyn-server/pull/414) a greatly expanded range of options.
+* `TestEndpointReachable` tests that a TCP endpoint can be reached.
+* `TestWinrmCommand` tests the success of commands in Windows instances.
+* `RelativeEntityTestCase` lets you write test cases that resolve their target from another entity.
+
+Additionally, location customisers can now be attached to entities as
+initialisers, rather than having to dig into their `templateOptions`.
+
+
+#### Brooklyn server
+
+* The REST API requires CSRF headers for non-GET and HEAD requests when
+ sessions are in effect.
+ See [CsrfTokenFilter](https://brooklyn.apache.org/v/0.10.0/misc/javadoc/org/apache/brooklyn/rest/filter/CsrfTokenFilter.html)
+ for details.
+
+* The catalogue scanner can be configured with whitelists and blacklists
+ of bundle IDs to control which bundles may present applications in the catalogue.
+
+* The Karaf distribution includes equivalents of the
+ [cloud explorer commands](https://brooklyn.apache.org/v/0.10.0/ops/server-cli-reference.html#cloud-explorer).
--- End diff --
Agree. The example I was referring to is:
```
{{ site.path.v }}/0.9.0/misc/release-notes.html
```
This makes it possible to have the docs live under a different root, possible a local one for development, testing. Or a staging area for the docs.
---
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.
---
[GitHub] brooklyn-docs pull request #128: 0.10.0 release notes
Posted by sjcorbett <gi...@git.apache.org>.
Github user sjcorbett closed the pull request at:
https://github.com/apache/brooklyn-docs/pull/128
---
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.
---