Skip to content

microsoft/TeamCloud

Repository files navigation

TeamCloud

TeamCloud is a tool that enables enterprise IT organizations to provide application development teams "self-serve" access to secure compliant cloud development environments.

Create Release GitHub release (latest by date)

There are several components that make up the TeamCloud solution.

TeamCloud CLI

The TeamCloud CLI is an extension for the Azure CLI. It can be used by application development teams to create and manage Projects, and by TeamCloud admins to create new TeamCloud instances or manage existing instances.

Install TeamCloud CLI

To install the Azure CLI TeamCloud extension, simply run the following command:

az extension add --source https://github.com/microsoft/TeamCloud/releases/latest/download/tc-0.5.3-py2.py3-none-any.whl -y

Update TeamCloud CLI

To update Azure CLI TeamCloud extension to the latest version:

az tc update

or for the latest pre-release version:

az tc update --pre

TeamCloud Instance

At the center of the tool is a TeamCloud instance (the source code in this repository). An enterprise deploys a single TeamCloud instance to an Azure subscription managed by its IT organization.

A TeamCloud instance is composed of two parts:

  1. A web portal
  2. A REST API that enables TeamCloud admins to manage the TeamCloud instance, and application development teams to create and manage Projects.
  3. An internal orchestration service (sometimes referred to as "the orchestrator") that communicates handles deployment and management.

TeamCloud Azure Resources

A TeamCloud instance is made up of the following Azure resources:

These resources are deployed using the CLI. After installing the CLI use az tc deploy -h deployment instructions.

TeamCloud Website

Although the TeamCloud CLI exposes all functionality provided by TeamCloud, you can also deploy a client website to interact with your instance.

Projects

A TeamCloud instance define templates (Project Types) for a policy-compliant, secure, cloud development environment, which software development teams can create on-demand. In the context of TeamCloud, these cloud development environments are called Projects.

About

This project is in active development and will change. As the tool becomes ready for use, it will be versioned and released.

We will do our best to conduct all development openly by documenting features and requirements, and managing the project using issues, milestones, and projects.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.