You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flex.apache.org by cd...@apache.org on 2016/09/29 15:07:38 UTC
git commit: [flex-falcon]
[refs/heads/feature-autobuild/maven-archetypes] - - Added some documentation
on the autobuilds.
Repository: flex-falcon
Updated Branches:
refs/heads/feature-autobuild/maven-archetypes 49e4ee199 -> 35c5ab2b2
- Added some documentation on the autobuilds.
Project: http://git-wip-us.apache.org/repos/asf/flex-falcon/repo
Commit: http://git-wip-us.apache.org/repos/asf/flex-falcon/commit/35c5ab2b
Tree: http://git-wip-us.apache.org/repos/asf/flex-falcon/tree/35c5ab2b
Diff: http://git-wip-us.apache.org/repos/asf/flex-falcon/diff/35c5ab2b
Branch: refs/heads/feature-autobuild/maven-archetypes
Commit: 35c5ab2b2f65ba83c87603fc0c1ab789ddde6409
Parents: 49e4ee1
Author: Christofer Dutz <ch...@codecentric.de>
Authored: Thu Sep 29 16:47:22 2016 +0200
Committer: Christofer Dutz <ch...@codecentric.de>
Committed: Thu Sep 29 16:47:22 2016 +0200
----------------------------------------------------------------------
src/site/asciidoc/featurebranch-autobuild.adoc | 45 +++++++++++++++++++
.../featurebranch-autobuild-branch-overview.png | Bin 0 -> 309602 bytes
.../featurebranch-autobuild-overview.png | Bin 0 -> 121026 bytes
src/site/site.xml | 5 ++-
4 files changed, 49 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/35c5ab2b/src/site/asciidoc/featurebranch-autobuild.adoc
----------------------------------------------------------------------
diff --git a/src/site/asciidoc/featurebranch-autobuild.adoc b/src/site/asciidoc/featurebranch-autobuild.adoc
new file mode 100644
index 0000000..47803ac
--- /dev/null
+++ b/src/site/asciidoc/featurebranch-autobuild.adoc
@@ -0,0 +1,45 @@
+////
+
+ 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.
+
+////
+
+= Featurebranch Autobuild
+
+When working on a feature it is a great benefit to have this automatically quality asured by a CI server.
+
+Manually setting up build-jobs for every feature branch for FlexJS is usually quite a lot of work. For that reason a lot of feature development is done on the `develop` branch.
+
+In order to encourage people to implement new features on a feature-branch and merge it back to `develop` as soon as it's finished we have setup a system to automate the creation and execution of CI builds.
+
+The FlexJS compiler module contains a `Jenkinsfile` which describes the setup of a Jenkins build pipeline to build the entire FlexJS stack of tools.
+
+The ASF Jenkins is setup to automatically build the `develop` branch of all modules (flexjs-compiler, flexjs-typedefs and flexjs-framework) as soon as something changes in the GIT repo.
+
+Here's a link to that particular job: https://builds.apache.org/view/E-G/view/Flex/job/FlexJS%20Pipeline/
+
+Additionally as soon as Jenkins detects a branch with the prefix of `feature-autobuild/`, it sets up a new Build job for that branch and starts automatically building that branch.
+
+image::development/featurebranch-autobuild-overview.png[Overview over all branches currently being built]
+
+Currently this requires all modules (compiler, typedefs and framework) to have an equally named branch, but we will dramatically improve this in the near future.
+
+image::development/featurebranch-autobuild-branch-overview.png[Detail view of a particular branch]
+
+
+
+
+
http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/35c5ab2b/src/site/resources/images/development/featurebranch-autobuild-branch-overview.png
----------------------------------------------------------------------
diff --git a/src/site/resources/images/development/featurebranch-autobuild-branch-overview.png b/src/site/resources/images/development/featurebranch-autobuild-branch-overview.png
new file mode 100644
index 0000000..ea3e9f6
Binary files /dev/null and b/src/site/resources/images/development/featurebranch-autobuild-branch-overview.png differ
http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/35c5ab2b/src/site/resources/images/development/featurebranch-autobuild-overview.png
----------------------------------------------------------------------
diff --git a/src/site/resources/images/development/featurebranch-autobuild-overview.png b/src/site/resources/images/development/featurebranch-autobuild-overview.png
new file mode 100644
index 0000000..0acdb09
Binary files /dev/null and b/src/site/resources/images/development/featurebranch-autobuild-overview.png differ
http://git-wip-us.apache.org/repos/asf/flex-falcon/blob/35c5ab2b/src/site/site.xml
----------------------------------------------------------------------
diff --git a/src/site/site.xml b/src/site/site.xml
index 64df894..01472a2 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -17,7 +17,7 @@
limitations under the License.
-->
-<project name="Maven">
+<project name="Maven" xmlns="https://maven.apache.org/xsd/decoration-1.7.0.xsd">
<!-- Use the nicer looking fluido skin instead of the default -->
<skin>
@@ -48,9 +48,12 @@
<!--item name="Download" href="download.html"/>
<item name="Release Notes" href="release-notes.html" />
<item name="General Information" href="about.html"/-->
+ </menu>
+ <menu name="Development">
<!-- Generated from src/site/asciidoc/build.adoc -->
<item name="Building from Source" href="build.html"/>
+ <item name="Featurebranch Autobuilds" href="featurebranch-autobuild.html"/>
<item name="Build structure" href="structure.html"/>
</menu>