Skip to content

Commit fadae20

Browse files
authored
Revert "Hosted runtime reqs (#849)" (#872)
This reverts commit 2f4bd34.
1 parent 2f4bd34 commit fadae20

File tree

3 files changed

+36
-56
lines changed

3 files changed

+36
-56
lines changed

_docs/installation/gitops/hosted-runtime.md

Lines changed: 3 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -10,24 +10,15 @@ toc: true
1010

1111
Set up your environment with the Hosted GitOps Runtime to leverage Codefresh GitOps capabilities.
1212

13-
>**IMPORTANT**:
14-
Codefresh is responsible for the _availability of Hosted GitOps Runtimes_.<br>
15-
The Argo CD applications created in Hosted GitOps Runtimes are the customer's responsibility. Codefresh Support is happy to assist as needed.
16-
1713

1814
## System requirements for Hosted GitOps Runtimes
1915

2016
{: .table .table-bordered .table-hover}
2117
| Item | Requirement |
2218
| -------------- | -------------- |
23-
|Kubernetes cluster | Server version 1.18|
24-
|Target Kubernetes clusters | {::nomarkdown} <ul><li>At least one target cluster to which to deploy Argo CD applications. <br>The actual number of target clusters depends on package sizing.</li><li>Must have public access from Internet</li></ul>{:/}|
25-
|Argo CD managed CRDs (Custom Resource Definitions) | Between 300 and 400 CRDs |
26-
|Git provider | {::nomarkdown}<ul><li>GitHub</li><!---<li>GitLab Cloud</li>--><li>Bitbucket Cloud (contact Support)</li><li>Gerrit (contact Support)</li></ul>{:/}|
27-
|Git repo for manifests | Up to 100MB|
28-
|CMP (Cloud Management Platform) plugins | Only for Enterprise customers |
19+
|Kubernetes cluster | Server version 1.18 and higher to which to deploy applications|
20+
|Git provider | {::nomarkdown}<ul><li>GitHub</li><!---<li>GitLab Cloud</li>--><li>Bitbucket Cloud</li><li>Gerrit</li></ul>{:/}|
2921

30-
For a comparison between Hosted and Hybrid GitOps Runtimes, see [Hosted vs. Hybrid GitOps]({{site.baseurl}}/docs/installation/installation-options/#hosted-vshybrid-gitops).
3122

3223
## Where to start with Hosted GitOps Runtimes
3324
If you have not provisioned a Hosted GitOps Runtime, Codefresh presents you with the setup instructions in the **Home** dashboard.
@@ -145,7 +136,7 @@ max-width="70%"
145136
Connect your Hosted GitOps Runtime to a Git provider for Codefresh to create the required Git repos.
146137

147138
**Authorize access**
148-
Based on the Git provider you select, you need to authorize access through OAuth or an access token, and then select the Git organizations or accounts in which to create the required Git repos.
139+
Based on the Git provider you select, you need to authorize access through OAuth or access token, and then select the Git organizations or accounts in which to create the required Git repos.
149140

150141
**Git organizations/accounts**
151142
Only authorized organizations are displayed in the list. To authorize organizations for the Codefresh application in GitHub, see [Authorize organizations/projects]({{site.baseurl}}/docs/administration/account-user-management/hosted-authorize-orgs/).

_docs/installation/gitops/hybrid-gitops-helm-installation.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,8 @@ We have transitioned to a Helm-based installation for Hybrid GitOps Runtimes for
1212
The CLI-based installation for Hybrid GitOps is considered legacy. We will deprecate this installation mode permanently in the coming months.<br>
1313
You can migrate existing CLI-based GitOps Runtimes to Helm-based ones, as described in [Migrating GitOps Runtimes from CLI to Helm]({{site.baseurl}}/docs/installation/gitops/migrate-cli-runtimes-helm/).
1414

15-
This article walks you through the process of installing Hybrid GitOps Runtimes in your Codefresh accounts using Helm charts. You can install a single GitOps Runtime on a cluster. To install additional Runtimes in the same account, each account must be on a different cluster. Every Runtime within your account must have a unique name.
16-
17-
For Hosted GitOps Runtimes, see [Hosted GitOps Runtime Setup]({{site.baseurl}}/docs/installation/gitops/hosted-runtime/).
1815

16+
This article walks you through the process of installing Hybrid GitOps Runtimes in your Codefresh accounts using Helm charts. You can install a single GitOps Runtime on a cluster. To install additional Runtimes in the same account, each account must be on a different cluster. Every Runtime within your account must have a unique name.
1917

2018
**Installation options for GitOps Runtimes**
2119
There are two options for Hybrid GitOps Runtime installation via Helm, each catering to specific use cases:
@@ -44,8 +42,7 @@ Choose the installation option that best aligns with your specific requirements
4442
* **Additional GitOps Runtime installation**
4543
If you have already installed a GitOps Runtime in your account and want to install additional Runtimes on different clusters within the same account, you can continue with a [simplified installation](#install-additional-gitops-runtimes-in-account) from the Codefresh UI, or use [Terraform](/install-gitops-runtime-via-terraform).
4644
When installing additional GitOps Runtimes, Git provider, Shared Configuration Repository, and the repository for the Helm chart, for example, are not required, as they have been already set up for your account.
47-
48-
45+
4946
>**ArgoCD password WARNING**:
5047
Avoid changing the Argo CD password using the `argocd-initial-admin-secret` via the Argo CD UI. Doing so can cause system instability and disrupt the Codefresh platform.
5148

@@ -939,8 +936,6 @@ You can [monitor]({{site.baseurl}}/docs/deployments/gitops/applications-dashboar
939936
|Git access tokens | {::nomarkdown}Git runtime token:<ul><li>Valid expiration date</li><li><a href="https://codefresh.io/docs/docs/reference/git-tokens/#git-runtime-token-scopes">Scopes</a> </li></ul></ul>{:/}|
940937
| |Git user token:{::nomarkdown}<ul><li>Valid expiration date</li><li><a href="https://codefresh.io/docs/docs/reference/git-tokens/#git-user-access-token-scopes">Scopes</a> </li></ul>{:/}|
941938

942-
For a comparison between Hosted and Hybrid GitOps Runtimes, see [Hosted vs. hybrid GitOps]({{site.baseurl}}/docs/installation/installation-options/#hosted-vshybrid-gitops).
943-
944939

945940
## Ingress controller configuration
946941

@@ -1646,4 +1641,4 @@ providers:
16461641
[Add Git Sources to GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/git-sources/)
16471642
[Add external clusters to GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/managed-cluster/)
16481643
[GitOps architecture]({{site.baseurl}}/docs/installation/runtime-architecture/#gitops-architecture)
1649-
[Installation options]({{site.baseurl}}/docs/installation/installation-options/)
1644+

_docs/installation/installation-options.md

Lines changed: 30 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: "Installation options"
3-
description: "Understand different installation options supported by Codefresh"
3+
description: "Understand Codefresh installation options"
44
group: installation
55
redirect_from:
66
- /docs/administration/installation-security/
77
toc: true
88
---
99

10-
The Codefresh platform supports different installation options for Codefresh pipelines and Codefresh GitOps, all compliant with [SOC2 - Type2](https://us.aicpa.org/interestareas/frc/assuranceadvisoryservices/aicpasoc2report){:target="\_blank"}.
10+
The Codefresh platform supports three different installation options, all compliant with [SOC2 - Type2](https://us.aicpa.org/interestareas/frc/assuranceadvisoryservices/aicpasoc2report){:target="\_blank"}.
1111

1212
{% include image.html
1313
lightbox="true"
@@ -18,7 +18,7 @@ The Codefresh platform supports different installation options for Codefresh pip
1818
%}
1919

2020

21-
**Codefresh pipeline installation options**
21+
2222
* **Hybrid Runner**
2323
The Runner installation is the hybrid installation mode for Codefresh pipelines. The Codefresh UI runs in the Codefresh cloud, and the builds run on customer premises. The Runner combines flexibility with security, and is optimal for Enterprise customers looking for a "behind-the-firewall" solution.
2424
See [Hybrid Runner](#hybrid-runner).
@@ -27,19 +27,19 @@ The Codefresh platform supports different installation options for Codefresh pip
2727
* **On-Premises**
2828
On-Premises installation is for customers who want full control over their environments. Both the UI and the builds run on the Kubernetes cluster in an environment fully managed by you as our customer.
2929

30-
While Codefresh can still help with maintenance of the On-Premises platform, we would recommend the Hybrid Runner installation for Codefresh piplines as it combines flexibility without compromising on security.
30+
While Codefresh can still help with maintenance of the On-Premises platform, we would recommend the Hybrid Runner as it combines flexibility without compromising on security.
3131
See [On-premises](#on-premises).
3232

33-
**Codefresh GitOps installation options**
3433

35-
GitOps is a full-featured solution for application deployments and releases powered by the Argo Project. Codefresh uses Argo CD, Argo Workflows, Argo Events, and Argo Rollouts, extended with unique functionality and features essential for enterprise deployments.
34+
* **GitOps**
35+
GitOps installation is a full-featured solution for application deployments and releases powered by the Argo Project. Codefresh uses Argo CD, Argo Workflows, Argo Events, and Argo Rollouts, extended with unique functionality and features essential for enterprise deployments.
36+
37+
GitOps installations support Hosted and Hybrid options.
38+
See [GitOps](#gitops).
3639

37-
GitOps supports Hosted and Hybrid Runtime installation options.
38-
See [GitOps](#gitops).
3940

40-
## Codefresh pipelines
41+
## Note on Cloud Builds for Codefresh pipelines
4142

42-
### Note on Cloud Builds for Codefresh pipelines
4343

4444
Cloud Builds for Codefresh pipelines are disabled for all accounts by default.
4545
Account admins can request Codefresh to enable Cloud Builds for an account. There is no manual action required except to click on the Enable Cloud Builds button as shown below. The timeframe for the response is up to 24 hours.<br>
@@ -60,7 +60,7 @@ If you [create a free account]({{site.baseurl}}/docs/quick-start/create-codefres
6060

6161

6262

63-
### Hybrid Runner
63+
## Hybrid Runner
6464

6565
The Hybrid Runner installation is for organizations who want their source code to live within their premises, or have other security constraints. For implementation details, see [[Runner installation behind firewalls]({{site.baseurl}}/docs/installation/behind-the-firewall).
6666
The UI runs on Codefresh infrastructure, while the builds happen in a Kubernetes cluster in the customer's premises.
@@ -112,21 +112,21 @@ The table lists the security implications of Hybrid Runner installation.
112112

113113

114114

115-
### On-premises
115+
## On-premises
116116

117-
For customers who want full control over Codefresh pipelines, Codefresh also offers on-premises installation option. Both the UI and builds run on a Kubernetes cluster fully managed by the customer.
117+
For customers who want full control, Codefresh also offers on-premises installation. Both the UI and builds run on a Kubernetes cluster fully managed by the customer.
118118

119119
See [Codefresh On-Prem Installation & Configuration]({{site.baseurl}}/docs/installation/codefresh-on-prem).
120120

121121

122-
## Codefresh GitOps
122+
## GitOps
123123

124-
Codefresh GitOps supports SaaS and hybrid installation options for GitOps Runtimes. For the main differences between Hosted and Hybrid GitOps, see [Hosted vs. Hybird GitOps]({{site.baseurl}}/docs/installation/installation-options/#hosted-vshybrid-gitops).
124+
Codefresh GitOps also supports SaaS and hybrid installation options:
125125

126126

127-
### Hosted GitOps Runtimes
127+
### Hosted GitOps
128128
The SaaS version of GitOps, Hosted GitOps has Argo CD installed in the Codefresh cluster.
129-
The Hosted GitOps Runtime is installed and provisioned on a Codefresh cluster, and managed by Codefresh.
129+
Hosted GitOps Runtime is installed and provisioned in a Codefresh cluster, and managed by Codefresh.
130130
Hosted environments are full-cloud environments, where all updates and improvements are managed by Codefresh, with zero-maintenance overhead for you as the customer.
131131
Currently, you can add one Hosted GitOps Runtime per account.
132132
For the architecture, see [Hosted GitOps Runtime architecture]({{site.baseurl}}/docs/installation/runtime-architecture/).
@@ -146,8 +146,8 @@ For the architecture, see [Hosted GitOps Runtime architecture]({{site.baseurl}}/
146146

147147
### Hybrid GitOps
148148
The hybrid version of GitOps, has Argo CD installed in the customer's cluster.
149-
The Hybrid GitOps Runtime is installed in the customer's cluster, and managed by the customer.
150-
Hybrid GitOps is optimal for organizations with security constraints, wanting to manage CI/CD operations within their premises. Hybrid GitOps strikes the perfect balance between security, flexibility, and ease of use. Codefresh maintains and manages most aspects of the platform, apart from installing and upgrading Hybrid GitOps Runtimes which are managed by the customer.
149+
Hybrid GitOps is installed in the customer's cluster, and managed by the customer.
150+
The Hybrid GitOps Runtime is optimal for organizations with security constraints, wanting to manage CI/CD operations within their premises. Hybrid GitOps strikes the perfect balance between security, flexibility, and ease of use. Codefresh maintains and manages most aspects of the platform, apart from installing and upgrading Hybrid GitOps Runtimes which are managed by the customer.
151151

152152

153153
{% include
@@ -160,7 +160,7 @@ Hybrid GitOps is optimal for organizations with security constraints, wanting to
160160
max-width="70%"
161161
%}
162162

163-
For more information on Hybrid GitOps, see [Hybrid GitOps Runtime requirements]({{site.baseurl}}/docs/installation/gitops/hybrid-gitops-helm-installation/#minimum-system-requirements) and [Hybrid GitOps Runtime Runtime installation]({{site.baseurl}}/docs/installation/gitops/hybrid-gitops-helm-installation/).
163+
For more information on Hybrid GitOps, see [Hybrid GitOps Runtime requirements]({{site.baseurl}}/docs/installation/gitops/hybrid-gitops-helm-installation/#minimum-system-requirements) and [Hybrid GitOps Runtime Runtime installation]({{site.baseurl}}/docs/installation/gitops/hybrid-gitops-helm-installation/).
164164

165165

166166

@@ -177,43 +177,37 @@ The runtime:
177177
* Receives events and information from the user's organization systems to execute workflows
178178
By default, the ingress controller directs all requests and events to the Codefresh Application Proxy. When internal and an external ingress hosts are configured, the ingress comtroller directs webhook events to the relevant Event Source and then to Argo Events (not via the Codefresh Application Proxy). -->
179179

180-
### Hosted vs.Hybrid GitOps Runtimes
180+
### Hosted vs.Hybrid GitOps
181181

182-
The table below highlights the main differences in functionality and resources between Hosted and Hybrid GitOps.
182+
The table below highlights the main differences between Hosted and Hybrid GitOps.
183183

184184
{: .table .table-bordered .table-hover}
185-
|Feature |Functionality | Hosted | Hybrid |
185+
| GitOps Functionality |Feature | Hosted | Hybrid |
186186
| -------------- | -------------- |--------------- | --------------- |
187187
| Runtime | Installation | Provisioned by Codefresh | Provisioned by customer |
188188
| | Runtime cluster | Managed by Codefresh | Managed by customer |
189-
| | Number per account | One Runtime | Multiple Runtimes, one per cluster |
190-
| | Target cluster | {::nomarkdown}<ul><li>Managed by customer</li><li>Number supported depends on package size and can range from 5 to 20 or higher</li><li>Network access: Public access from internet</li></ul>{:/} | {::nomarkdown}<ul><li>Managed by customer</li><li>Any number</li><li>Network access: Public or private access</li></ul>{:/} |
189+
| | Number per account | One runtime | Multiple runtimes, one per cluster |
190+
| | External cluster | Managed by customer | Managed by customer |
191191
| | Upgrade | Managed by Codefresh | Managed by customer |
192192
| | Uninstall | Managed by customer | Managed by customer |
193-
|Resources |Argo CD managed CRDs (Custom Resource Definitions)| Between 300 and 400 CRDs |Unlimited |
194-
| |Mono Git repo for manifests | Max size up to 100MB | Unlimited |
195-
| | CMP (Cloud Management Platform) plugins |Only for Enterprise customers |N/A |
196193
| Argo CD | | Codefresh cluster | Customer cluster |
197194
| CI Ops | Delivery Pipelines |Not supported | Supported |
198195
| |Workflows | Not supported | Supported |
199196
| |Workflow Templates | Not supported | Supported |
200-
| CD Ops |Applications |{::nomarkdown}<ul><li>Deployment supported only on target clusters</li><li>Self-healing interval: 90 seconds<br>See <a href="https://argo-cd.readthedocs.io/en/stable/user-guide/auto_sync/#automatic-self-healing">Argo CD automatic self-healing</a></li></ul> {:/} | {::nomarkdown}<ul><li>Deployment supported on both in-cluster and target clusters</li><li>Self-healing interval: 5 seconds (Argo CD default)<br>See <a href="https://argo-cd.readthedocs.io/en/stable/user-guide/auto_sync/#automatic-self-healing">Argo CD automatic self-healing</a></li></ul> {:/}|
197+
| CD Ops |Applications | Supported | Supported |
201198
| |Image enrichment | Supported | Supported |
202199
| | Rollouts | Supported | Supported |
203200
|Integrations | | Supported | Supported |
204-
|Dashboards |Home | Hosted Runtime and deployments|Runtimes, deployments, Delivery Pipelines |
201+
|Dashboards |Home | Hosted runtime and deployments|Runtimes, deployments, Delivery Pipelines |
205202
| |DORA metrics | Supported |Supported |
206-
| |GitOps Apps | Supported |Supported |
207-
| |GitOps Environments | Supported |Supported |
208-
| |GitOps Products | Supported |Supported |
209-
203+
| |Applications | Supported |Supported |
210204

211205

212206
## Installation options comparison
213207
Codefresh Runner and GitOps environments can co-exist giving you the best of both worlds.
214208

215209
{: .table .table-bordered .table-hover}
216-
| Characteristic | Hybrid Runner | On Premises | GitOps
210+
| Characteristic | Hybrid Runner | On Premise | GitOps
217211
| -------------- | ---------------------------- |-------------------------| ----------------|
218212
| Managed by | Codefresh and customer | Customer | Codefresh and customer |
219213
| UI runs on | Public cloud | Private cluster | Public cloud|
@@ -227,5 +221,5 @@ Codefresh Runner and GitOps environments can co-exist giving you the best of bot
227221
## Related articles
228222
[Architecture]({{site.baseurl}}/docs/installation/runtime-architecture/)
229223
[Add Git Sources to GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/git-sources/)
230-
[Shared Configuration Repository]({{site.baseurl}}/docs/installation/gitops/shared-configuration)
224+
[Shared Configuration Repositorysitory]({{site.baseurl}}/docs/installation/gitops/shared-configuration)
231225

0 commit comments

Comments
 (0)