Update site for 0.8.0 release
Project: http://git-wip-us.apache.org/repos/asf/twill/repo Commit: http://git-wip-us.apache.org/repos/asf/twill/commit/c852eb67 Tree: http://git-wip-us.apache.org/repos/asf/twill/tree/c852eb67 Diff: http://git-wip-us.apache.org/repos/asf/twill/diff/c852eb67 Branch: refs/heads/site Commit: c852eb67b21ee279e425187f645a196e1771ef1e Parents: 9ea6dac Author: Terence Yim <[email protected]> Authored: Tue Oct 4 10:48:17 2016 -0700 Committer: Terence Yim <[email protected]> Committed: Wed Oct 5 14:41:45 2016 -0700 ---------------------------------------------------------------------- src/site/markdown/GettingStarted.md | 14 ++-- src/site/markdown/ReleaseGuide.md | 5 +- src/site/markdown/index.md | 4 +- src/site/markdown/releases/0.5.0-incubating.md | 61 ----------------- src/site/markdown/releases/0.6.0-incubating.md | 74 --------------------- src/site/markdown/releases/0.8.0.md | 63 ++++++++++++++++++ src/site/site.xml | 8 +-- 7 files changed, 79 insertions(+), 150 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/GettingStarted.md ---------------------------------------------------------------------- diff --git a/src/site/markdown/GettingStarted.md b/src/site/markdown/GettingStarted.md index ba8d5de..00d7f1b 100644 --- a/src/site/markdown/GettingStarted.md +++ b/src/site/markdown/GettingStarted.md @@ -28,7 +28,7 @@ For your application module <dependency> <groupId>org.apache.twill</groupId> <artifactId>twill-api</artifactId> - <version>0.7.0-incubating</version> + <version>0.8.0</version> </dependency> ``` @@ -38,7 +38,7 @@ For the your Apache Twill YARN client module <dependency> <groupId>org.apache.twill</groupId> <artifactId>twill-yarn</artifactId> - <version>0.7.0-incubating</version> + <version>0.8.0</version> </dependency> ``` @@ -116,7 +116,7 @@ to create an instance of `TwillRunnerService`: ```java TwillRunnerService runnerService = new YarnTwillRunnerService( new YarnConfiguration(), zkConnectStr); -runnerService.startAndWait(); +runnerService.start(); ``` Now you are read to run the EchoServer on YARN, by simply preparing and starting through the `TwillRunnerService`. You @@ -143,7 +143,7 @@ controller.addListener(new ListenerAdapter() { You can also stop the application through the `TwillController`: ```java -controller.stop().get(); +controller.terminate().get(); ``` This will shut down the application master and all the containers. @@ -170,7 +170,7 @@ You can run the HelloWorld application from any node of the Hadoop cluster using (be sure to add your ZooKeeper Host and Port): ```sh -$ export CP=twill-examples-yarn-0.7.0-incubating-SNAPSHOT.jar:`hadoop classpath` +$ export CP=twill-examples-yarn-0.8.0.jar:`hadoop classpath` $ java -cp $CP org.apache.twill.example.yarn.HelloWorld {zookeeper_host:port} ``` @@ -193,9 +193,9 @@ You can run the BundleJarExample application from any node of the Hadoop cluster (be sure to add your ZooKeeper Host and Port): ```sh -$ export CP=twill-examples-yarn-0.7.0-incubating-SNAPSHOT.jar:`hadoop classpath` +$ export CP=twill-examples-yarn-0.8.0.jar:`hadoop classpath` $ java -cp $CP org.apache.twill.example.yarn.BundledJarExample {zookeeper_host:port} \ - twill-examples-echo-0.7.0-incubating-SNAPSHOT.jar echo.EchoMain arg1 + twill-examples-echo-0.8.0.jar echo.EchoMain arg1 ``` Like with the HelloWorld example, you should see logs output to the terminal. Once the application is complete, check http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/ReleaseGuide.md ---------------------------------------------------------------------- diff --git a/src/site/markdown/ReleaseGuide.md b/src/site/markdown/ReleaseGuide.md index 86253ab..3d37c59 100644 --- a/src/site/markdown/ReleaseGuide.md +++ b/src/site/markdown/ReleaseGuide.md @@ -173,7 +173,10 @@ ${RELEASE_VERSION} passed with n binding +1s and no 0 or -1. Binding +1s: [BINDING_+1_NAMES] -I am going to create a vote in the general@ list. +Non-binding +1s +[NON_BINDING_+1_NAMES] + +This release vote has passed. Thanks everyone for voting. Thanks, [YOUR_NAME] http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/index.md ---------------------------------------------------------------------- diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md index fe34a8d..f1ceab4 100644 --- a/src/site/markdown/index.md +++ b/src/site/markdown/index.md @@ -43,8 +43,8 @@ Hadoop® cluster. ### Latest Release -The latest release of Apache Twill is [0.7.0-incubating](releases/0.7.0-incubating.html). -Please go to the [release](releases/0.7.0-incubating.html) page +The latest release of Apache Twill is [0.8.0](releases/0.8.0.html). +Please go to the [release](releases/0.8.0.html) page to find out more. ### Is it Building? http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/releases/0.5.0-incubating.md ---------------------------------------------------------------------- diff --git a/src/site/markdown/releases/0.5.0-incubating.md b/src/site/markdown/releases/0.5.0-incubating.md deleted file mode 100644 index debee40..0000000 --- a/src/site/markdown/releases/0.5.0-incubating.md +++ /dev/null @@ -1,61 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. ---> - -<head> - <title>Apache Twill Release 0.5.0-incubating</title> -</head> - -### Release Notes - Apache Twill - 0.5.0-incubating - -#### New Features: - * [TWILL-111](https://issues.apache.org/jira/browse/TWILL-111) Support MapR File System - * [TWILL-115](https://issues.apache.org/jira/browse/TWILL-115) Add support to submit jobs to non-default YARN queue - * [TWILL-118](https://issues.apache.org/jira/browse/TWILL-118) Added support for distributed lock - -#### Bug fixes: - * [TWILL-61](https://issues.apache.org/jira/browse/TWILL-61) Second launch attempt of AM always failed - * [TWILL-80](https://issues.apache.org/jira/browse/TWILL-80) Logs not available when the runnable failed at initialize or only runs momentarily - * [TWILL-100](https://issues.apache.org/jira/browse/TWILL-100) Fix examples poms - * [TWILL-108](https://issues.apache.org/jira/browse/TWILL-108) Not to fail with exception if the same jar file has been added twice during creation of bundle jar - * [TWILL-110](https://issues.apache.org/jira/browse/TWILL-110) Deadlock when shutting down runnable container - -### Project dependencies - -#### Maven -For your application module - -```xml -<dependency> - <groupId>org.apache.twill</groupId> - <artifactId>twill-api</artifactId> - <version>0.5.0-incubating</version> -</dependency> -``` - -For the your Apache Twill YARN client module - -```xml -<dependency> - <groupId>org.apache.twill</groupId> - <artifactId>twill-yarn</artifactId> - <version>0.5.0-incubating</version> -</dependency> -``` - -### Source tar-ball download -[Source and signatures](http://www.apache.org/dyn/closer.cgi/incubator/twill/0.5.0-incubating/src) http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/releases/0.6.0-incubating.md ---------------------------------------------------------------------- diff --git a/src/site/markdown/releases/0.6.0-incubating.md b/src/site/markdown/releases/0.6.0-incubating.md deleted file mode 100644 index 2e8ff6a..0000000 --- a/src/site/markdown/releases/0.6.0-incubating.md +++ /dev/null @@ -1,74 +0,0 @@ -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. ---> - -<head> - <title>Apache Twill Release 0.6.0-incubating</title> -</head> - -### Release Notes - Apache Twill - 0.6.0-incubating - -#### New Features: - * [TWILL-116](https://issues.apache.org/jira/browse/TWILL-116) Support for restart instances of runnable in an application - * [TWILL-117](https://issues.apache.org/jira/browse/TWILL-117) MapR extension - * [TWILL-130](https://issues.apache.org/jira/browse/TWILL-130) Remove support for Java 6 - -#### Improvements: - * [TWILL-24](https://issues.apache.org/jira/browse/TWILL-24) log level should be settable - * [TWILL-69](https://issues.apache.org/jira/browse/TWILL-69) Remove guava dependencies on the twill-api and twill-common modules - * [TWILL-83](https://issues.apache.org/jira/browse/TWILL-83) distribute YarnTestUtils for easier downstream testing - * [TWILL-112](https://issues.apache.org/jira/browse/TWILL-112) Improve ApplicationBundler performance - * [TWILL-126](https://issues.apache.org/jira/browse/TWILL-126) Update Travis CI configuration to support caching Maven downloads - * [TWILL-128](https://issues.apache.org/jira/browse/TWILL-128) Change the ZKBrokerService to be public so it could be used outside the package - * [TWILL-135](https://issues.apache.org/jira/browse/TWILL-135) Update the pom.xml to get Java7 API link and update copyright year - * [TWILL-137](https://issues.apache.org/jira/browse/TWILL-137) Be able to get log level for each runnable via TwillController.getResourceReport - -#### Bug fixes: - * [TWILL-120](https://issues.apache.org/jira/browse/TWILL-120) Java 8 applications causing exceptions - * [TWILL-121](https://issues.apache.org/jira/browse/TWILL-121) Do not know which class TwillLauncher was trying to launch - * [TWILL-125](https://issues.apache.org/jira/browse/TWILL-125) BundledJarRunner doesn't work for classes with no zero-args constructor - * [TWILL-127](https://issues.apache.org/jira/browse/TWILL-127) The link for API doc for 0.6 release returns 404 - * [TWILL-129](https://issues.apache.org/jira/browse/TWILL-129) Race condition in leader election if leader quitted before follower set the watch - * [TWILL-133](https://issues.apache.org/jira/browse/TWILL-133) ZookeeperClientService may hang at startup and then cannot be stopped - * [TWILL-136](https://issues.apache.org/jira/browse/TWILL-136) Override equals and hashCode for JvmOptions.DebugOptions to test equality - * [TWILL-139](https://issues.apache.org/jira/browse/TWILL-139) ApplicationMaster hangs during start when ZooKeeper SASL authentication is turned on - -### Project dependencies - -#### Maven -For your application module - -```xml -<dependency> - <groupId>org.apache.twill</groupId> - <artifactId>twill-api</artifactId> - <version>0.6.0-incubating</version> -</dependency> -``` - -For the your Apache Twill YARN client module - -```xml -<dependency> - <groupId>org.apache.twill</groupId> - <artifactId>twill-yarn</artifactId> - <version>0.6.0-incubating</version> -</dependency> -``` - -### Source tar-ball download -[Source and signatures](http://www.apache.org/dyn/closer.cgi/incubator/twill/0.6.0-incubating/src) http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/markdown/releases/0.8.0.md ---------------------------------------------------------------------- diff --git a/src/site/markdown/releases/0.8.0.md b/src/site/markdown/releases/0.8.0.md new file mode 100644 index 0000000..f686396 --- /dev/null +++ b/src/site/markdown/releases/0.8.0.md @@ -0,0 +1,63 @@ +<!-- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + +<head> + <title>Apache Twill Release 0.8.0</title> +</head> + +### Release Notes - Apache Twill - 0.8.0 + +#### Improvements: + * [TWILL-107](https://issues.apache.org/jira/browse/TWILL-107) Support payloads for Discoverables + * [TWILL-167](https://issues.apache.org/jira/browse/TWILL-167) Add toString() to FileContextLocation + * [TWILL-184](https://issues.apache.org/jira/browse/TWILL-184) Allow user to disable the SecureStoreUpdater in Twill + * [TWILL-188](https://issues.apache.org/jira/browse/TWILL-188) LocationFactory should have options to accept permission for create + +#### Bug fixes: + * [TWILL-163](https://issues.apache.org/jira/browse/TWILL-163) LocationFactory.getHomeLocation method returns home location of the user running the application instead of the user that owns the hdfs directories. + * [TWILL-173](https://issues.apache.org/jira/browse/TWILL-173) Application Master failed with BindException occasionally + * [TWILL-175](https://issues.apache.org/jira/browse/TWILL-175) Hadoop21YarnAppClient caches a YarnClient + * [TWILL-177](https://issues.apache.org/jira/browse/TWILL-177) ZKDiscoveryService should have a way to remove its connection watcher + * [TWILL-182](https://issues.apache.org/jira/browse/TWILL-182) ApplicationBundler will overwrite dependencies with identical names + * [TWILL-190](https://issues.apache.org/jira/browse/TWILL-190) Restart of a TwillRunnable does not wait for the runnable to stop + +### Project dependencies + +#### Maven +For your application module + +```xml +<dependency> + <groupId>org.apache.twill</groupId> + <artifactId>twill-api</artifactId> + <version>0.8.0</version> +</dependency> +``` + +For the your Apache Twill YARN client module + +```xml +<dependency> + <groupId>org.apache.twill</groupId> + <artifactId>twill-yarn</artifactId> + <version>0.8.0</version> +</dependency> +``` + +### Source tar-ball download +[Source and signatures](http://www.apache.org/dyn/closer.cgi/incubator/twill/0.8.0/src) http://git-wip-us.apache.org/repos/asf/twill/blob/c852eb67/src/site/site.xml ---------------------------------------------------------------------- diff --git a/src/site/site.xml b/src/site/site.xml index 2ac0850..0d4a86a 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -51,16 +51,14 @@ <menu name="Documentation"> <item name="Getting Started" href="./GettingStarted.html"/> - <item name="API (0.8.0-SNAPSHOT)" href="./apidocs/index.html"/> + <item name="API (0.9.0-SNAPSHOT)" href="./apidocs/index.html"/> + <item name="API (0.8.0)" href="./apidocs-0.8.0/index.html"/> <item name="API (0.7.0-incubating)" href="./apidocs-0.7.0-incubating/index.html"/> - <item name="API (0.6.0-incubating)" href="./apidocs-0.6.0-incubating/index.html"/> - <item name="API (0.5.0-incubating)" href="./apidocs-0.5.0-incubating/index.html"/> </menu> <menu name="Releases"> + <item name="0.8.0" href="./releases/0.8.0.html"/> <item name="0.7.0-incubating" href="./releases/0.7.0-incubating.html"/> - <item name="0.6.0-incubating" href="./releases/0.6.0-incubating.html"/> - <item name="0.5.0-incubating" href="./releases/0.5.0-incubating.html"/> </menu> <menu name="Get Involved">
