From 109b8163ace7f5c8ac30c9464cacb531650029ac Mon Sep 17 00:00:00 2001 From: Grant Young Date: Thu, 17 Feb 2022 10:33:57 +0000 Subject: [PATCH 01/13] Add note to RA docs about supported Cloud Providers --- .../reference_architectures/index.md | 143 +++++++++++++++++- 1 file changed, 135 insertions(+), 8 deletions(-) diff --git a/doc/administration/reference_architectures/index.md b/doc/administration/reference_architectures/index.md index 815155866e8d96..d49524c23cfb98 100644 --- a/doc/administration/reference_architectures/index.md +++ b/doc/administration/reference_architectures/index.md @@ -73,6 +73,7 @@ The following reference architectures are available. ### Cloud native hybrid + The following Cloud Native Hybrid reference architectures, where select recommended components can be run in Kubernetes, are available: - [Up to 2,000 users](2k_users.md#cloud-native-hybrid-reference-architecture-with-helm-charts-alternative) @@ -87,6 +88,140 @@ to get assistance from Support with troubleshooting the [2,000 users](2k_users.m and higher reference architectures. [Read more about our definition of scaled architectures](https://about.gitlab.com/support/#definition-of-scaled-architecture). +### Supported Cloud Providers and Services + +NOTE: +The following lists are non exhaustive. Generally other Cloud Providers not listed +here will likely work with the same specs but note this hasn't been verified. +Additionally when it comes to other Cloud Provider Services not listed here +it's advised to be cautious as each implementation can be notably different +and should be tested thoroughly before production use. + +Through testing and real life usage the Reference Architectures are verified and supported on the following Cloud Providers: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
GCPAWSAzureOn Prem
Omnibus
Cloud Native Hybrid
+ +Additionally the following Cloud Provider Services are validated and supported for use as part of the Reference Architectures: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +Finally it should be noted that the following Cloud Provider Services have been found to have issues in terms of either functionality or performance and are not recommended at this time: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +NOTE: +As a general rule we unfortunately don't recommend Azure Services at this time. +If required we advise thorough testing is done at your intended scale +over a sustained period to verify if the Service is suitable. + ### Validation and test results The [Quality Engineering - Enablement team](https://about.gitlab.com/handbook/engineering/quality/quality-engineering/) does regular smoke and performance tests for the reference architectures to ensure they remain compliant. @@ -131,7 +266,6 @@ table.test-coverage th { Omnibus Cloud Native Hybrid Omnibus - Cloud Native Hybrid 1k @@ -140,7 +274,6 @@ table.test-coverage th { - 2k @@ -149,7 +282,6 @@ table.test-coverage th { - 3k @@ -158,7 +290,6 @@ table.test-coverage th { - 5k @@ -167,7 +298,6 @@ table.test-coverage th { - 10k @@ -176,7 +306,6 @@ table.test-coverage th { Ad-Hoc (inc Cloud Services) Ad-Hoc Ad-Hoc - 25k @@ -185,7 +314,6 @@ table.test-coverage th { Ad-Hoc - 50k @@ -194,7 +322,6 @@ table.test-coverage th { Ad-Hoc (inc Cloud Services) - -- GitLab From 98d1090efc5240a0b12e9a91d09161c77bbb774e Mon Sep 17 00:00:00 2001 From: Grant Young Date: Thu, 17 Feb 2022 12:13:54 +0000 Subject: [PATCH 02/13] Further updates --- .../reference_architectures/index.md | 101 ++++++------------ 1 file changed, 35 insertions(+), 66 deletions(-) diff --git a/doc/administration/reference_architectures/index.md b/doc/administration/reference_architectures/index.md index d49524c23cfb98..26b0022384cdbb 100644 --- a/doc/administration/reference_architectures/index.md +++ b/doc/administration/reference_architectures/index.md @@ -73,7 +73,6 @@ The following reference architectures are available. ### Cloud native hybrid - The following Cloud Native Hybrid reference architectures, where select recommended components can be run in Kubernetes, are available: - [Up to 2,000 users](2k_users.md#cloud-native-hybrid-reference-architecture-with-helm-charts-alternative) @@ -112,15 +111,15 @@ Through testing and real life usage the Reference Architectures are verified and Omnibus - - - - + ✅ + ✅ + ✅ + ✅ Cloud Native Hybrid - - + ✅ + ✅ @@ -129,94 +128,64 @@ Through testing and real life usage the Reference Architectures are verified and Additionally the following Cloud Provider Services are validated and supported for use as part of the Reference Architectures: - - +
- - - - - + + + + - - - - - + + + + - - - - - + + + + - - - - - + + + +
GCPAWSOn Prem
Object Storage✅ Cloud Storage✅ S3✅ MinIO
Database✅ Cloud SQL✅ RDS
Redis✅ Elasticache
-Finally it should be noted that the following Cloud Provider Services have been found to have issues in terms of either functionality or performance and are not recommended at this time: +Finally it should be noted that the following Cloud Provider Services have been found to have issues in terms of either functionality or performance and are either not recommended or not recommended at this time: - - +
- - - - - + + - - - - - + + - - - - - + + - - - - - + +
Azure
Object Storage🟡 Blob Storage¹
Database❌ PostgreSQL Single / Flexible Server
Redis
+1. Azure Blob Storage has been found to have performance limits that can impact production use at certain times. For larger Reference Architectures the service may not be sufficient for production use and an alternative is recommended for use instead. + NOTE: As a general rule we unfortunately don't recommend Azure Services at this time. If required we advise thorough testing is done at your intended scale -- GitLab From 25f1e6d20d6a8092d02597aefefd84e886e0b9d3 Mon Sep 17 00:00:00 2001 From: Grant Young Date: Thu, 17 Feb 2022 12:30:14 +0000 Subject: [PATCH 03/13] Lint fix --- doc/administration/reference_architectures/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/administration/reference_architectures/index.md b/doc/administration/reference_architectures/index.md index 26b0022384cdbb..287d45b8f31072 100644 --- a/doc/administration/reference_architectures/index.md +++ b/doc/administration/reference_architectures/index.md @@ -159,7 +159,7 @@ Additionally the following Cloud Provider Services are validated and supported f -Finally it should be noted that the following Cloud Provider Services have been found to have issues in terms of either functionality or performance and are either not recommended or not recommended at this time: +Finally it should be noted that the following Cloud Provider Services have been found to have issues in terms of either functionality or performance and are either not recommended or not recommended at this time: -- GitLab From 5369c12280aa58c435d1ef6830e11504eb245088 Mon Sep 17 00:00:00 2001 From: Grant Young Date: Thu, 17 Feb 2022 12:36:23 +0000 Subject: [PATCH 04/13] Format table further --- .../reference_architectures/index.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/doc/administration/reference_architectures/index.md b/doc/administration/reference_architectures/index.md index 287d45b8f31072..808debf18185f8 100644 --- a/doc/administration/reference_architectures/index.md +++ b/doc/administration/reference_architectures/index.md @@ -101,7 +101,7 @@ Through testing and real life usage the Reference Architectures are verified and
- + @@ -131,7 +131,7 @@ Additionally the following Cloud Provider Services are validated and supported f
Reference
Architecture		 GCP AWS Azure
- + @@ -140,20 +140,20 @@ Additionally the following Cloud Provider Services are validated and supported f - - - + + + - - + + - + @@ -207,12 +207,14 @@ The following table details the testing done against the reference architectures
Cloud Service GCP AWS On Prem
Object Storage✅ Cloud Storage✅ S3✅ MinIO✅   Cloud Storage✅   S3✅   MinIO
Database✅ Cloud SQL✅ RDS✅   Cloud SQL✅   RDS
Redis ✅ Elasticache✅   Elasticache