# community-edition
**Repository Path**: NQL886/community-edition
## Basic Information
- **Project Name**: community-edition
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-05-10
- **Last Updated**: 2022-05-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Tanzu Community Edition
Tanzu Community Edition is a fully-featured, easy to manage, Kubernetes platform
for learners and users. It is a freely available, community supported, and open
source distribution of VMware Tanzu. It can be installed and deployed in minutes to your
local workstation or favorite infrastructure provider. Along with cluster
management, powered by [Cluster API](https://github.com/kubernetes-sigs/cluster-api),
Tanzu Community Edition enables higher-level functionality via its robust
[package management](https://tanzucommunityedition.io/docs/edge/package-management)
built on top of [Carvel's kapp-controller](https://carvel.dev/kapp-controller/),
and opinionated, yet extensible, [Carvel packages](#packages).
[](https://bestpractices.coreinfrastructure.org/projects/4906)
[](https://github.com/vmware-tanzu/community-edition/actions/workflows/build-staging.yaml)
[](https://github.com/vmware-tanzu/community-edition/actions/workflows/check-all.yaml)
[](https://github.com/vmware-tanzu/community-edition/actions/workflows/check-imagelint.yaml)
[](https://github.com/vmware-tanzu/community-edition/actions/workflows/e2e-vsphere-management-and-workload-cluster.yaml)
[](https://github.com/vmware-tanzu/community-edition/actions/workflows/e2e-azure-management-and-workload-cluster.yaml)
[](https://github.com/vmware-tanzu/community-edition/actions/workflows/e2e-aws-management-and-workload-cluster.yaml)
[](https://github.com/vmware-tanzu/community-edition/actions/workflows/e2e-unmanaged-cluster.yaml)
## Getting Started
* [Getting Started Guide](https://tanzucommunityedition.io/docs/edge/getting-started)
## Installation
We recommend installing Tanzu Community Edition using a package manager. If that
is not possible, manual steps are detailed last.
### Mac/Linux via homebrew
```sh
brew install vmware-tanzu/tanzu/tanzu-community-edition
```
After install, homebrew will prompt you with a configure script, run it.
```txt
******************************************************************************
* To initialize all plugins required by TCE, an additional step is required.
* To complete the installation, please run the following shell script:
*
* ${HOMEBREW_EXEC_DIR}/configure-tce.sh
******************************************************************************
```
### Windows via chocolatey
```sh
choco install tanzu-community-edition
```
### Manual (Mac/Linux/Windows)
1. [Download the release tarball](https://github.com/vmware-tanzu/community-edition/releases) based on your operating system.
1. Unpack the release tarball.
* Unzip on Windows.
* `tar zxvf ` on Mac/Linux.
1. Enter the directory of the unpacked release.
1. Run the install script.
* `.\install.bat` on Windows as Administrator.
* `./install.sh` on Mac/Linux
## Packages
Packages provide higher-level functionality to build atop your Kubernetes-based
platform. Packages included, by default, in Tanzu Community Edition are:
| Name | Description | Documentation |
|------|-------------|---------------|
| Cert Manager | Provides certificate management provisioning within the cluster | [Cert Manager package docs](./addons/packages/cert-manager) |
| Contour | Provides ingress support to workloads | [Contour package docs](./addons/packages/contour) |
| ExternalDNS | Provides discoverability of services via public DNS | [ExternalDNS package docs](./addons/packages/external-dns) |
| Fluent-Bit | Log processor and forwarder | [Fluent Bit package docs](./addons/packages/fluent-bit) |
| Gatekeeper | Provides policy enforcement within clusters | [Gatekeeper package docs](./addons/packages/gatekeeper) |
| Grafana | Metrics visualization and analytics | [Grafana package docs](./addons/packages/grafana) |
| Harbor | Provides cloud native container registry service | [Harbor package docs](./addons/packages/harbor) |
| Knative Serving | Provides serving functionality to clusters | [Knative serving package docs](./addons/packages/knative-serving) |
| Load Balancer Operator | Provides load balancer integrations to clusters | [Load Balancer Operator package docs](./addons/packages/ako-operator) |
| Local Path Storage| Provides local path storage | [Local path storage docs](./addons/packages/local-path-storage) |
| Kpack | Utilizes unprivileged Kubernetes primitives to provide builds of OCI images | [Kpack docs](./addons/packages/kpack) |
| Multus CNI | Provides ability for attaching multiple network interfaces to pods in Kubernetes | [Multus CNI package docs](./addons/packages/multus-cni) |
| Prometheus | Time series database for metrics. Includes AlertManager | [Prometheus package docs](./addons/packages/prometheus) |
| Sriov Network Device Plugin | The SR-IOV Network Device Plugin is Kubernetes device plugin for discovering and advertising SR-IOV virtual functions (VFs) available on a Kubernetes host. | [Sriov Network Device Plugin package docs](./addons/packages/sriov-network-device-plugin) |
| Velero | Provides disaster recovery capabilities | [Velero package docs](./addons/packages/velero) |
| Whereabouts | Provides A CNI IPAM plugin that assigns IP addresses cluster-wide | [Whereabouts package docs](./addons/packages/whereabouts) |
## Contributing
If you are ready to jump in and test, add code, or help with documentation,
follow the instructions on our [Contribution Guidelines](https://tanzucommunityedition.io/docs/edge/contribute/contributing/) to
get started and at all times, follow our [Code of
Conduct](./CODE_OF_CONDUCT.md).
Before opening an issue or pull request, please search for any existing issues
or existing pull requests. If an issue does not exist, please create one for
your feedback! If one exists, please feel free to comment and add any
additional context you may have!
## Latest Daily Build
Here are quick pointers to the latest **unsigned development** builds for:
* [Linux AMD64 - 2022-05-10](https://storage.googleapis.com/tce-cli-plugins-staging/build-daily/2022-05-10/tce-linux-amd64-v0.13.0-dev.1.tar.gz)
* [Darwin AMD64 - 2022-05-10](https://storage.googleapis.com/tce-cli-plugins-staging/build-daily/2022-05-10/tce-darwin-amd64-v0.13.0-dev.1.tar.gz)
* [Windows AMD64 - 2022-05-10](https://storage.googleapis.com/tce-cli-plugins-staging/build-daily/2022-05-10/tce-windows-amd64-v0.13.0-dev.1.zip)
## Repository Layout
The following describes the key directories that make up this repository.
* `addons/`: the source configuration of our packages and package repository
available to be installed in TCE clusters
* `packages/`: software packages installable in TCE clusters
* `repos/`: bundles of packages that can be installed in TCE clusters
making all packages within available
* `cli/`: plugins that add TCE-specific functionality to the `tanzu` CLI
* `cmd/plugin/${PLUGIN_NAME}/`: individual plugin project and go module
* `docs/`: documentation and our hugo-based website
* `hack/`: scripts used for development and build processes
* `test/`: scripts, configuration, and code used for end-to-end testing
## Support
If you have any questions about Tanzu Community Edition, please join [#tanzu-community-edition](https://kubernetes.slack.com/messages/tanzu-community-edition) on [Kubernetes slack](http://slack.k8s.io/).
Please submit [bugs or enhancements requests](https://github.com/vmware-tanzu/community-edition/issues/new/choose) in GitHub.
More information about troubleshooting and our triage process is available [here](https://tanzucommunityedition.io/docs/edge/trouble-faq/).
Information about our roadmap is available [here](https://github.com/vmware-tanzu/community-edition/blob/main/ROADMAP.md).
---
## Join the Community and Make Tanzu Community Edition Better
Tanzu Community Edition is better because of our contributors and maintainers. It is because of you that we can bring great software to the community. Please join us during our online community meetings. Details can be found on our [website](https://tanzucommunityedition.io/community/).
You can chat with us on Kubernetes Slack in the [#tanzu-community-edition channel](https://kubernetes.slack.com/archives/C02GY94A8KT) and follow us on Twitter at [@VMwareTCE](https://twitter.com/VMwareTCE).
Note: If you aren’t already a member on the Kubernetes Slack workspace, please first [request an invitation](https://slack.k8s.io/) to gain access.
Check out which organizations are using and contributing to Tanzu Community Edition: [Adopter's list](https://github.com/vmware-tanzu/community-edition/blob/main/ADOPTERS.md)
Share how you are using Tanzu Community Edition with the community by adding a comment to this [pinned issue](https://github.com/vmware-tanzu/community-edition/issues/3295).