Apache CloudStack: Open Source Cloud Computing

X-Mailer: ASF-Git Admin Mailer Subject: [08/39] cloudstack-www git commit: rename build dir to content dir http://git-wip-us.apache.org/repos/asf/cloudstack-www/blob/c170b446/content/developers.html ---------------------------------------------------------------------- diff --git a/content/developers.html b/content/developers.html new file mode 100644 index 0000000..ac2406a --- /dev/null +++ b/content/developers.html @@ -0,0 +1,322 @@ + + + + Apache CloudStack: Open Source Cloud Computing + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + + +

+ +

Contributing as a Non-Committer

+ +

If you're a committer on an Apache project, it means that you can commit directly to the project's repository. For instance, with Apache CloudStack committers are allowed to directly push commits into the git repository.

+ +

Non-committers, however, have to submit patches for review. Don't worry, it's not an onerous process at all. The first time you submit a patch, it will take a minute or two to create an account on Review Board, but it's a piece of cake from start to finish.

+ +

Assumptions

+ +

For the purpose of this post, we'll assume that you already have a system with Git and have found a bug to fix or have a feature that you'd like to submit, and you're willing to contribute that code or documentation under the Apache License 2.0.

+ +

Further, if you're fixing a bug we'll assume that you've either filed a bug report or are submitting a fix for a known bug. If you find a bug and would like to fix it, that's awesome! Please be sure to file the bug too, though.

+ +

If you want to add a feature, you should bring it up for discussion on the dev@cloudstack.apache.org mailing list before implementing it. This ensures that it meshes with the plans that other contributors have for Apache CloudStack, and that you're not doing redundant work. Other developers may also have ideas for the feature or suggestions that will help you land the feature without having to re-do the work. More information about our mailing lists can be found here.

+ +

In short, communication is a vital part of making a contribution to an Apache project.

+ +

Getting Started

+ +

First, lets make sure that you've added your name and email to your `~/.gitconfig`:

+ +

+$ git config --global user.name "Your Name"
+$ git config --global user.email you@domain.com
+

+ +

You'll grab the CloudStack source with git:

+ +

+$ git clone https://git-wip-us.apache.org/repos/asf/cloudstack.git
+

+ +

If you already have the source, make sure you're working with the most recent version. Do a `git pull` if you cloned the source more than a few hours ago. (Apache CloudStack development can move pretty fast!)

+ +

+$ git checkout -b mybranch
+

+ +

This does two things: One, it creates the branch mybranch and two, it changes your working branch to mybranch. Running `git branch` will show you which branch you're working on, with an asterisk next to the active branch, like so:

+ +

+[user@localhost cloudstack]$ git branch
+  master
+  * mybranch
+

+ +

Make whatever changes you're going to make, be sure to use git add to stage the changes, and then you're going to commit the changes to your working branch:

+ +

git commit -m "Insert a meaningful summary of changes here."

+ +

Finally, you're going to create a patch to upload to Review Board:

+ +

git format-patch master --stdout > ~/patch-name.patch

+ +

Using Review Board

+ +

Review Board is the main method of sending patches to the Apache CloudStack project. That's not to say that a patch sent directly to the mailing list will be ignored, but the strong preference is that patches be submitted through Review Board. Don't worry, it's a very easy tool to use.

+ +

If you haven't already, create an account with Review Board. Registering only requires an email address, first name, and last name. After you're registered, head to New Review Request and select the repository (cloudstack-git) and upload the patch (diff) created with git.

+ +

Click Create Review Request and then fill out the information required. Specifically:

+ +

Summary
Groups (choose cloudstack)
People (only use if you need specific committers to review changes)
Description
Testing Done

+ +

The Summary will be the subject that's sent to the cloudstack-dev mailing list. So if your summary is "fixed feature foo" the subject of the mail sent to the list will be "Review Request: fixed feature foo". Try to be descriptive with the Summary. If you're submitting a patch for a bug, please be sure to include the bug number in the summary. (Like "Bugfix CS-15942: Fixing problem with redundant routers.")

+ +

The description should be a full description of what you've done. Please be specific, and include enough information that any reviewer will be able to look at your patch without asking for follow-up information. You need to include the bug ID that your patch relates to as well (ex: CLOUDSTACK-XXX ).

+ +

If you're submitting a patch that modifies code, adds features, etc. you should test before submitting. Please be sure to describe your tests here.

+ +

Once you're sure everything is OK, go ahead and submit the patch. But that's not the end of the process. The work isn't done until the patch is committed!

+ +

Review

+ +

Once you've submitted your patch, you should receive a response within a few days. If you receive no response within a week, please ping the cloudstack-dev mailing list. One of the features of Review Board is that shows all of the requests and when they were posted, and the committers know that they should be responsible for reviewing patches in a timely fashion.

+ +

When your patch is reviewed, it may be accepted as-is or you may be asked to make changes. If you're asked to make changes, please work with the committer to see the patch through to acceptance.

+ +

If the patch is accepted and committed, you have one last task (don't worry, it's minor and kind of satisfying).

+ +

Go back to Review Board, click My Dashboard and then Outgoing Reviews. Go to your submission, you should see a "Ship it!" message from the reviewer. Click the Close button and choose Submitted. The status has now changed from pending to submitted.

+ +

That's it – you've helped make Apache CloudStack a better project. Thanks!

+ +

Screencast

+ +

If you are new to git you might want to watch this screencast:

+ + + +

Git Repositories

+ +

The git repositories are hosted on Apache infrastructure, and can be found here:

+ +

Apache CloudStack https://git-wip-us.apache.org/repos/asf/cloudstack.git
Apache CloudStack CloudMonkey https://git-wip-us.apache.org/repos/asf/cloudstack-cloudmonkey.git

+ +

To get the most recent source for Apache CloudStack, use:

+ +

+git clone https://git-wip-us.apache.org/repos/asf/cloudstack.git
+

+ +

Similarly, clone the cloudstack-cloudmonkey repository to get access to the most recent source for CloudMonkey.

+ +

For projects related to Apache CloudStack, see the CloudStack-extras repositories on GitHub.

+ +

+ + +

+ +

+ + + + +

+ + + http://git-wip-us.apache.org/repos/asf/cloudstack-www/blob/c170b446/content/downloads.html ---------------------------------------------------------------------- diff --git a/content/downloads.html b/content/downloads.html new file mode 100644 index 0000000..45c9a4a --- /dev/null +++ b/content/downloads.html @@ -0,0 +1,334 @@ + + + + Apache CloudStack: Open Source Cloud Computing + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ +

+ + + +

+ +

Latest CloudStack Release

+ +

Source Release

+ +

Apache CloudStack's most current release is 4.4.2. +

+ +

+ + + + + + + +

+ +

+ + + + + + + +

+ +

Packages

+ +

For easier installation or upgrades, the official source code release has been supplemented by community members who have chosen to provide package repositories.

+ +

DEB package repository: http://cloudstack.apt-get.eu/ubuntu
RPM package repository: http://cloudstack.apt-get.eu/rhel/
CloudStack packages by ShapeBlue: http://shapeblue.com/packages

+ +

Instructions for using these community provided repositories can be found in the Configure Package Repository section of the Installation Guide.

+ + +

Release Notes for CloudStack 4.4.2

+ +

Full release notes can be found in the Version 4.4.2 Release Notes document.

+ +

Instructions for building from source and installing Apache CloudStack can be found in the Installation Guide.

+ +

Instructions for building from source and upgrading from a previous version of CloudStack to Apache CloudStack 4.4.2 can be found in the upgrade section of the Release Notes.

+ + +

Release Notes for CloudStack 4.3.2

+ +

Full release notes can be found in the Version 4.3.2 Release Notes document.

+ +

Instructions for building from source and installing Apache CloudStack can be found in the Installation Guide.

+ +

Instructions for building from source and upgrading from a previous version of CloudStack to Apache CloudStack 4.3.2 can be found in the upgrade section of the Release Notes.

+ + +

+ +

Verifying Downloads

+ +

+It's essential that you verify the integrity of the downloaded files using the PGP or MD5 signatures. +The PGP signatures can be verified using PGP or GPG. First download the +KEYS as well as the asc +signature file for the relevant distribution. Make sure you get these files from the +main distribution directory, rather than from a mirror. Then verify the signatures using: +

+    % pgpk -a KEYS
+    % pgpv apache-cloudstack-X.X.X-src.tar.bz2.asc
+

+    % pgp -ka KEYS
+    % pgp apache-cloudstack-X.X.X-src.tar.bz2.asc
+

+    % gpg --import KEYS
+    % gpg --verify apache-cloudstack-X.X.X-src.tar.bz2.asc
+

+Additionally, you can verify the MD5 or SHA512 signatures on the files. +

+ +

+ + + +

+ +

Apache CloudStack's CloudMonkey tool is a CLI and shell environment designed for interacting with CloudStack-based clouds.

+ +

Source Release

+ +

CloudMonkey's most current release is 5.3.1.

+ +

+ + + + + + + +

+ +

Instructions for building and installing from source can be found in the included README.md file.

+ +

PyPi Package

+ +

For easier installation or upgrades, the official source code release has been supplemented by community members who have pushed the python package to the Python Package Index.

+ +

For installing the package from pypi, use:

+ +

$ pip install cloudmonkey
+

+ +

To upgrade:

+ +

$ pip install --upgrade cloudmonkey
+

+ +

Though a clean upgrade is recommended:

+ +

$ pip uninstall cloudmonkey
+$ pip install cloudmonkey
+

+ +

+ + + + +

+ + + http://git-wip-us.apache.org/repos/asf/cloudstack-www/blob/c170b446/content/features.html ---------------------------------------------------------------------- diff --git a/content/features.html b/content/features.html new file mode 100644 index 0000000..cdf828c --- /dev/null +++ b/content/features.html @@ -0,0 +1,324 @@ + + + + Apache CloudStack: Open Source Cloud Computing + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Apache CloudStack Features

+ +

As a mature and turnkey Infrastructure-as-a-Service (IaaS) platform, Apache CloudStack has a comprehensive set of features. This is an extensive, but not exhaustive, set of features.

+ +

Have a feature request? We'd invite you to bring it up on the mailing list, and consider filing a feature request in our bug tracker.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ Feature +	+ Description +
Rich Management User Interface	CloudStack provides a feature-rich out-of-the-box user interface implemented on top of the CloudStack API to manage the cloud infrastructure. It is a fully AJAX based solution compatible with most of the latest internet browsers and can also be easily integrated with your existing portal.
Brand-able Self Service User Interface	Our out-of-the-box user interface was built using standard HTML and CSS with jQuery as our standard JavaScript library. It can be easily customized and branded to mirror your company’s existing look and feel.
Secure AJAX Console Access	A VNC AJAX client that allows users to access their virtual machine using any of the latest internet browsers without the need of any external add-on such as a JRE, ActiveX, or Flash.
Powerful API	Easily build, integrate, and use applications built on top of the CloudStack API. The CloudStack API is well-documented and extensible. CloudStack also includes support for the Amazon EC2 and S3 APIs.
Secure Single Sign On	Aggregate and integrate your existing applications with our management user interface via our secure single sign-on for a better user experience.
Multi-role Support	Three distinct account roles for user interface and API access are supported out-of-the-box: + + Admin: can manage both the virtual and physical resources of the cloud + Domain-Admin: can manage only the virtual resources owned by the accounts within their domain + User: can manage their own virtual resources + +
On Demand Virtual Data center Hosting	Provides users with virtually unlimited amount of computing resources – on demand, as required and billed by actual usage.
Dynamic Workload Management	Completely automates the distribution of compute, network, and storage resource across the physical infrastructure while adhering to defined policies on load balancing, data security, and compliance.
Broad network Virtualization Capabilities	Support for embedded software-based network management as well as VLAN. Our Direct Attached IP enables you to integrate with a virtual network architecture that best fits your needs.
MPLS Support in the Cloud	CloudStack allows you to dedicate an entire VLAN to a specific account for MPLS support between network nodes.
Secure Cloud Deployments	Ensures that all memory, CPU, network, and storage resources are both available and isolated from one user account to another within the cloud.
Hypervisor Agnostic	CloudStack provides you with the flexibility to allow you to integrate with the major hypervisors in the market today including VMware, KVM, Citrix XenServer, and Citrix Xen Cloud Platform.
Easy Template Creation Process	The CloudStack User Interface allows you to easily create pre-defined templates for efficient virtual machine deployments. Templates can be created by attaching a guest OS ISO to a blank VM or directly from existing VMs in the cloud.
Rich Template and ISO Management	Both users and administrators will be able to upload and manage their OS templates and ISO images from within the cloud. A few management features include the ability to allow others to use the templates/ISOs either on a global public level or on a per-account basis, and to allow the management of templates across multiple zones. CloudStack will ensure that templates are automatically copied to the appropriate storage servers.
Domains and Delegated Administration	The support for domains allows you to segregate your cloud resources and delegate the management of these domains to other administrators.
Snapshot Management	To help mitigate data loss and a way of disaster recovery, users are given the capability of either taking ad hoc snapshots of their disk volumes or setting up a comprehensive schedule for taking periodic snapshots of their data. Users can set limits to the number of snapshots taken to creating new data disk volumes from existing snapshots.
Comprehensive Service Management	Administrators can define, meter, deploy, and manage multiple service and disk offerings within the cloud.
VM Sync and High Availability	Our custom VM Sync technology constantly monitors and maintains the state of all virtual machines within the cloud from notifications of individual VM status to the ability to automatically ensure that the VM remains running.
Resource Over Provisioning and Limits	By leveraging existing hypervisor, storage, and network technologies, you can configure the cloud to allow over provisioning of physical resources to optimize the allocation of your virtual machines. + CloudStack also provides administrators the capability of limiting virtual resources (such as the number of VMs that an account can create to the number of public IP addresses an account can own). +
Usage Metering	Be able to deliver real-time visibility, produce historical usage reports, and create billing invoices by integrating with metering data generated by the CloudStack Usage Engine.
Alerts and Notifications	With built-in cloud system monitoring processes, you will be able to receive up-to-the-minute alerts such as reaching a certain physical resource threshold or detecting machine failures through the CloudStack API and/or via email using SMTP.
Virtual Routers, Firewalls and Load Balancers	CloudStack supports integration with both software and hardware firewalls and load balancers to provide additional security and scalability to a user’s cloud environment. Including F5 and Netscaler
Multiple Storage Solutions	CloudStack supports many storage solutions with iSCSI and NFS being preferred, but anything that can have multiple nodes mount it simultaneously will work. This gives you the ultimate freedom in deciding your storage servers from using commodity hardware to integrating with enterprise-grade solutions such as Dell EqualLogic or NetApp.
Storage Tiering	As part of the CloudStack’s ability to integrate with multiple storage solutions, you will also be able to target specific storage servers to be used for VM deployments. This can be extremely beneficial when you have storage servers built with commodity hardware to support non disk intensive applications and dedicate fast and robust hardware for disk intensive applications such as databases.
Block Storage Volumes	CloudStack supports the creation of block storage volumes of arbitrary size on both network attached storage (NAS) or local disk that can be attached and detached to and from your virtual machine.
Wide Range Guest VM OS Support	Depending on the configured hypervisor, CloudStack supports a wide range of guest operating system including Windows®, Linux®, and various versions of BSD®.
Event/Audit Logs	All user interactions via the CloudStack UI or API are recorded as events. Each event will indicate the type, severity level, description, owner of the resource, the user that initiated the action, and when the event occurred.
User Data Support	CloudStack supports the notion of allowing a user to submit any type of binary user data when deploying a new virtual machine. This gives you the flexibility of giving each virtual machine created from the same OS template its own identity in the cloud.
Guest OS Preferences	To take advantage of today’s hardware and OS licensing models, CloudStack allows administrators to identify physical hosts to “prefer” specific operating systems. For example this means that whenever possible, your Windows based operating systems will be instantiated on all hosts that have been identified as Windows “preferred.”
Host Maintenance with Live Migration	Upgrades and hardware maintenance can be achieved on the cloud with no downtime for guest VMs. CloudStack will live-migrate any VMs from hosts that have been targeted for maintenance to prevent any disruption of service.
Flexible Adapter Framework	The CloudStack was built from the ground up to support integration with a variety of hypervisors, storage, network, and authentication solutions. Due to this flexibility, we have created an Adapter Framework that will easily allow you to further customize the cloud to suit your business needs.
Random Password for Guest OS	You can further enhance your guest OS templates to include our custom random password feature that will automatically generate a unique password upon the creation of a VM. This will allow your customers to securely log in and change their password. Both Windows and Linux based OS platforms are currently supported.
OpenStack Swift Integration for Secondary Storage	Secondary storage (templates and VM snapshots) can be stored in OpenStack Swift as an alternative to NFS.
Projects	Allow users to collaborate and share resources within a defined group or "project". When a user creates an a project all usage under the project is attributed to the account who becomes the project owner.
Clustered LVM Support	CloudStack can utilize clustered Logical Volume Manager (LVM) storage configurations starting with version 3.0.
NetScaler Support	CloudStack supports MPX, VPX & SDX devices. Users can set up Layer-4 load balancing rules. Supported protocols: HTTP, TCP & UDP; Algorithms: least loaded and round robin; Persistent sessions: source IP based, cookie based.
Network As a Service	Admin can compose network offerings with different network behaviors. For example, a basic network offering with CloudStack Virtual Router offering network services and a high-performance network offering with physical devices such as NetScaler and Juniper SRX. Users can select the network offering of choice while deploying a VM and also migrate VMs from one network offering to another.
LDAP Integration	CloudStack supports LDAP authentication as a built-in optional AUTH adapter
Notification & Capacity Thresholds	Admin can set notification threshold to receive an alert when resource pool crosses the notification threshold. Capacity threshold prevents CloudStack from allocating further resources to that pool.

+ + + + + +

+ + + http://git-wip-us.apache.org/repos/asf/cloudstack-www/blob/c170b446/content/fonts/glyphicons-halflings-regular.eot ---------------------------------------------------------------------- diff --git a/content/fonts/glyphicons-halflings-regular.eot b/content/fonts/glyphicons-halflings-regular.eot new file mode 100644 index 0000000..87eaa43 Binary files /dev/null and b/content/fonts/glyphicons-halflings-regular.eot differ

Developer Resources for Apache CloudStack

Contributing as a Non-Committer

Assumptions

Getting Started

Using Review Board

Review

Screencast

Further Reading

Git Repositories

Apache CloudStack: Downloads

Latest CloudStack Release

Source Release

Packages

Release Notes for CloudStack 4.4.2

Release Notes for CloudStack 4.3.2

Verifying Downloads

Latest CloudMonkey Release

Source Release

PyPi Package

Archived Releases

Apache CloudStack Features

Feature

Description