Welcome to cloud-automation-samples

Overview

The cloud-automation-samples github project contains code to provision and manage applications in a multi-cloud environment through VMware cloud solutions. The VMware cloud-automation-samples team invites you to use this code as is, modify it for your use cases, and to contribute new code and documentation that aligns to the purpose of this project.

Navigating the Project

cloud-automation-samples is organized by VMware Product name and third party products for easy navigation. Enter the product folder to review and download code that can be used immediately in the referenced products. For the full application deployment sample, multiple VMware and non-VMware products are used together to provision, manage, and monitor the TITO application through a Codestream CI/CD pipeline.

Prerequisites

To use this code to its fullest potential, you must have an account on the correct VMware Solutions as well as any third party products you wish to integration. If you do not have a VMware cloud solutions account, you can access the solution pages to obtain a free trial.

VMware Cloud Assembly (https://cloud.vmware.com/cloud-assembly)

VMware Code Stream (https://cloud.vmware.com/code-stream)

Wavefront by VMware (https://cloud.vmware.com/wavefront)

vRealize Orchestrator (https://www.vmware.com/products/vrealize-orchestrator.html)

You must contact the non-VMware vendors directly to obtain access to their products.

This code is written to deploy to multi-cloud environments. Therefore, having accounts in AWS, Azure, and GCP is a great way to unlock the full potential of Cloud Assembly's cloud agnositc infrastructure-as-code. However, it is not necessary. You can also use your current vSphere environment for many of the samples.

Build & Run

Each directory contains descriptive readme files to describe the code available and how it is used. The cloud-automation-samples team also creates white papers, blogs, and videos describing the purpose of and how to use the code available in this project. For more information you can review the documentation at the Cloud Automation Services website (https://cloud.vmware.com/cloud-automation-services/resources).

Contributing

The cloud-automation-samples project team welcomes contributions from the community. Before you start working with cloud-automation-samples, please read our Developer Certificate of Origin. All contributions to this repository must be signed as described on that page. Your signature certifies that you wrote the patch or have the right to pass it on as an open-source patch. For more detailed information, refer to CONTRIBUTING.md.

License

cloud-automation-samples Copyright (c) 2019 VMware, Inc. All rights reserved

The BSD-2 license (the "License") set forth below applies to all parts of the cloud-automation-samples project. You may not use this file except in compliance with the License.

BSD-2 License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.