From e63ba73a4fca0c100bdf28d420ac1b1db944a84f Mon Sep 17 00:00:00 2001
From: Sam Bolian
Date: Mon, 13 Nov 2023 16:24:24 -0600
Subject: [PATCH 1/2] Update plural repo README.md
---
README.md | 53 ++++++++++++++++++++++++-----------------------------
1 file changed, 24 insertions(+), 29 deletions(-)
diff --git a/README.md b/README.md
index cccbf7d65..5240af495 100644
--- a/README.md
+++ b/README.md
@@ -4,11 +4,11 @@
- The fastest way to build great infrastructure
+ The fastest way to build great infrastructure and deploy your software
- Plural empowers you to build and maintain cloud-native and production-ready open source infrastructure on Kubernetes.
+ Plural empowers you to build and maintain cloud-native and production-ready infrastructure on Kubernetes.
@@ -16,7 +16,7 @@
-
+
@@ -38,13 +38,16 @@
## β¨ Features
-Plural will deploy open source applications on Kubernetes in your cloud using common standards like Helm and Terraform.
+Plural will deploy open-source applications and proprietary services on Kubernetes in your cloud using common standards like Helm and Terraform.
The Plural platform provides the following:
-* Dependency management between Terraform/Helm modules, with dependency-aware deployment and upgrades.
+* Cluster API Providers to create and manage clusters at scale.
+* Full visibility of your fleet and all deployed services via our secure Auth Proxy.
+* Configuration management for deployments, allowing you to parameterize services for each deployment.
+* Horizontal scaling to ingest and auto-shard as many repos as necessary.
+* Dependency management between Terraform/Helm modules for open-source applications, with dependency-aware deployment and upgrades.
* Authenticated docker registry and chartmuseum proxy per repository.
-* Secret encryption using AES-256 (so you can keep the entire workflow in git).
In addition, Plural also handles:
* Issuing the certificates.
@@ -61,7 +64,7 @@ We think it's pretty cool! π Some other nice things:
-The plural platform ingests all deployment artifacts needed to deploy cloud-native applications and tracks their dependencies, allowing for easy installs and no-touch upgrades post-install.
+The Plural platform also ingests all deployment artifacts needed to deploy open-source cloud-native applications, allowing for easy installs and no-touch upgrades post-install.
### π€ Day-2 Operational Toolkit
@@ -70,13 +73,19 @@ The plural platform ingests all deployment artifacts needed to deploy cloud-nati
-Scale deploys with operational run-books for key cluster operations. Every dependency is automatically upgraded in the correct order, in a rolling manner. Plural provides a timestamped audit trail for all cluster applications along with searchable, downloadable logs. In addition, there are also pre-packaged dashboards for the highest importance metrics.
+Monitor all your installations from one central control plane. Our Auth Proxy makes it easy to make secure Kubernetes API calls to give you full dashboarding capabilities for all your clusters, regardless of where they live without direct network access.
+
+Spin up ephemeral environments to test out new configurations in seconds; our CAPI providers make it easy to modify your architecture as you need it.
+
+Manage Kubernetes upgrades easily with our built-in Kubernetes API deprecation management - we surface all endpoints on all clusters that need to be addressed.
### π Secure by default
-Plural performs regular security scans for application images, helm charts, and terraform modules and comes equipped with OpenID connect for user auth to applications deployed by Plural.
+Plural is fully self-hosted within your own environment, meaning we don't touch your credentials or sensitive information.
+
+Cluster setup includes deploying our Plural deployment operator, which efficiently polls the control plane for any changes that need to be applied. This ensures that our control plane doesnβt reach into these workload clusters, providing a more secure setup than push-based models.
-### π₯³ Open source and extensible
-All Plural applications are fully customizable and able to be ejected at any time. New applications can be wrapped and packaged onto Plural easily, giving you total freedom about how, when and where to use Plural.
+### π₯³ Flexible configuration
+All Plural deployments are fully customizable with our centralized secrets management. Additionally, we natively support deploying to brand new clusters or adopting existing K8s clusters.
@@ -84,33 +93,19 @@ All Plural applications are fully customizable and able to be ejected at any tim
+https://github.com/pluralsh/plural/assets/1610133/43f8d4c5-c74b-4098-97e9-39c9ed302a16
-https://user-images.githubusercontent.com/3838088/236681124-4b557577-a67d-466c-8075-9008cd49be40.mp4
## π Getting Started
1. Go to https://app.plural.sh to create an account.
-*Note: This is simply to track your installations and allow for the delivery of automated upgrades, you will not be asked to provide any infrastructure credentials or sensitive information.*
+*Note: This is simply to track your open-source installations and deploy your Console; if you use our CLI you will not be asked to provide any infrastructure credentials or sensitive information.*
2. [Install the Plural CLI](https://docs.plural.sh/getting-started/getting-started#install-plural-cli)
3. [Create and initialize a new git repo](https://docs.plural.sh/getting-started/getting-started#create-your-plural-repo) to store your Plural installation.
-4. [Install, build and deploy applications](https://docs.plural.sh/getting-started/getting-started#install-plural-applications) from the Plural marketplace
-5. [Install the Plural Management Console](https://docs.plural.sh/basic-setup-and-deployment/admin-console).
-
-You should now have a fully functioning Plural environment with apps and the management console running. For more details or further information check out the rest of the docs below.
-
-### The Plural Workflow
-
-The workflow is literally two commands:
-
-```bash
-plural build
-plural deploy
-```
-
-Our tooling will take care of the rest.
-
+4. [Install, build and deploy Plural Console](https://docs.plural.sh/basic-setup-and-deployment/admin-console) and [any other applications](https://docs.plural.sh/getting-started/getting-started#install-plural-applications) from the Plural marketplace.
+You should now have a fully functioning Plural environment with any open-source apps and the management console running. From here, you can spin up additional clusters, deploy your services, track upgrades, and more. For more details or further information check out the rest of the docs below.
## π Documentation
From 2ae4ff97cc9993acde075da36a7bd437b0b6ddf5 Mon Sep 17 00:00:00 2001
From: Sam Bolian
Date: Mon, 13 Nov 2023 16:27:04 -0600
Subject: [PATCH 2/2] Add files via upload
---
www/public/deployment-services.png | Bin 0 -> 572756 bytes
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 www/public/deployment-services.png
diff --git a/www/public/deployment-services.png b/www/public/deployment-services.png
new file mode 100644
index 0000000000000000000000000000000000000000..efbaad2fc471c7f660bde46bf61f4b061c46de84
GIT binary patch
literal 572756
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