Return-Path: X-Original-To: apmail-cloudstack-commits-archive@www.apache.org Delivered-To: apmail-cloudstack-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 9595518FD9 for ; Sat, 4 Jul 2015 12:41:43 +0000 (UTC) Received: (qmail 68990 invoked by uid 500); 4 Jul 2015 12:41:43 -0000 Delivered-To: apmail-cloudstack-commits-archive@cloudstack.apache.org Received: (qmail 68887 invoked by uid 500); 4 Jul 2015 12:41:43 -0000 Mailing-List: contact commits-help@cloudstack.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cloudstack.apache.org Delivered-To: mailing list commits@cloudstack.apache.org Received: (qmail 68671 invoked by uid 99); 4 Jul 2015 12:41:43 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 04 Jul 2015 12:41:43 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 91D14E360A; Sat, 4 Jul 2015 12:41:42 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: pdion891@apache.org To: commits@cloudstack.apache.org Date: Sat, 04 Jul 2015 12:41:46 -0000 Message-Id: <0c35683cadad4e4ba2c55af5d33e5369@git.apache.org> In-Reply-To: <0a4b86dd3a964169b85201c0734a9a0c@git.apache.org> References: <0a4b86dd3a964169b85201c0734a9a0c@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [5/6] cloudstack-cloudmonkey git commit: Update contribution howto, add Docker howto Update contribution howto, add Docker howto Signed-off-by: pdion891 Project: http://git-wip-us.apache.org/repos/asf/cloudstack-cloudmonkey/repo Commit: http://git-wip-us.apache.org/repos/asf/cloudstack-cloudmonkey/commit/7b21d1d6 Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-cloudmonkey/tree/7b21d1d6 Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-cloudmonkey/diff/7b21d1d6 Branch: refs/heads/master Commit: 7b21d1d685d6fbfa06a8271711f8f198c65fed73 Parents: f0b840a Author: Pierre-Luc Dion Authored: Mon Jun 29 07:09:36 2015 -0400 Committer: pdion891 Committed: Sat Jul 4 08:27:51 2015 -0400 ---------------------------------------------------------------------- README.md | 52 +++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 37 insertions(+), 15 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cloudstack-cloudmonkey/blob/7b21d1d6/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index cf31ea3..fc1fec8 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,33 @@ with Apache CloudStack 4.0-incubating and above. ![version badge](https://badge.fury.io/py/cloudmonkey.png) ![download badge](http://img.shields.io/pypi/dm/cloudmonkey.png) + +### For users + +Install: + + $ pip install cloudmonkey + +Upgrade: + + $ pip install --upgrade cloudmonkey + +Please see the [CloudMonkey Wiki](https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+cloudmonkey+CLI) for usage. + + +### Using Docker image + +Use with CloudStack managemenent server as container: + + $ docker run -ti --rm --link cloudstack:8080 docker.io/cloudstack/cloudmonkey + +Use your own CloudMonkey configuration file: + + $ docker run -ti --rm -v `pwd`/.cloudmonkey:/cloudmonkey docker.io/cloudstack/cloudmonkey + + +### Build + All: Cleans and then builds with precache @@ -36,17 +63,6 @@ Install: $ make install -### For users - -Install: - - $ pip install cloudmonkey - -Upgrade: - - $ pip install --upgrade cloudmonkey - -Please see the [CloudMonkey Wiki](https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+cloudmonkey+CLI) for usage. ### Mailing lists @@ -60,14 +76,20 @@ Please see the [CloudMonkey Wiki](https://cwiki.apache.org/confluence/display/CL [Marketing Mailing List](mailto:marketing-subscribe@cloudstack.apache.org) -### Contributing -Send your patches on Apache [Review Board](https://reviews.apache.org/groups/cloudstack/) -for CloudStack CloudMonkey. +### Contributing -Discuss features development on the `Dev` mailing lists. +Discuss features development on the [Development Mailing List](mailto:dev-subscribe@cloudstack.apache.org). Report issues on the `User` mailing list and open issue on [JIRA](http://issues.apache.org/jira/browse/CLOUDSTACK). +1. Fork the repository on Github +2. Create a named feature branch (like `add_component_x`) +3. Write your change +4. Write tests for your change (if applicable) +5. Run the tests, ensuring they all pass +6. Submit a Pull Request using Github + + ### License Licensed to the Apache Software Foundation (ASF) under one