You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
* Update git-sources.mdAdded cf- prefix requirement to namespace for restricted git sources* Add cf- prefix for namespacesAdded cf- prefix requirement for namespaces and updated example and flow diagram to match* Update git-sources.mdAdded cf- to example manifests* Update git-sources.md* Update git-sources.mdAdded configmap location where these namespace prefixes are added* Update git-sources.md
Copy file name to clipboardExpand all lines: _docs/installation/gitops/git-sources.md
+11-10Lines changed: 11 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -200,7 +200,8 @@ Let's see how to achieve this for a single team, the Hulk team.
200
200
Let's name the Git repo`marvel-hulk-team-apps`.
201
201
202
202
1.**Create destination namespace for deployment**
203
-
Create the namespace on the cluster to which Hulk applications can be deployed. Let's name it,`hulk-apps-zone`.
203
+
Create the namespace on the cluster to which Hulk applications can be deployed. Let's name it,`cf-hulk-apps-zone`.
204
+
Note that the Namespace must start with the prefix`cf-`.
204
205
205
206
1.**Create a Restricted Git Source**
206
207
Create the Restricted Git Source for the Hulk team that will define the namespace to which to deploy application manifests, and the namespace to which to deploy the applications themselves.
@@ -215,7 +216,7 @@ Let's see how to achieve this for a single team, the Hulk team.
215
216
***Path**:`.`
216
217
1. Leave the other settings empty, and click**Next**.
217
218
1. Specify the deployment settings:
218
-
***Source Namespace**: Define the namespace to which to deploy the application manifests. Because we want to enforce permissions, we will define`hulk-app-manifests` as the namespace. If the namespace does not exist, Codefresh will automatically create it.
219
+
***Source Namespace**: Define the namespace to which to deploy the application manifests. Because we want to enforce permissions, we will define`cf-hulk-app-manifests` as the namespace. The`cf-` prefox is mandatory for the namespace. If the namespace does not exist, Codefresh will automatically create it.
219
220
***Allowed Clusters & Namespaces**: Select the relevant cluster and namespace to which to deploy the applications. Let's select`hulk-apps-zone` as the namespace to which to deploy applications.
220
221
1. Click**Create**.
221
222
You have now created the Restricted Git Source.
@@ -279,7 +280,7 @@ You must be in the List View for GitOps Runtimes to create Git Sources.
279
280
280
281
##Git Source settings
281
282
The table describes the settings you can define for Standard and Restricted Git Sources.
282
-
For how-to, see[Create a Git Source](#create-a-git-source).
283
+
For how-to instructions, see[Create a Git Source](#create-a-git-source).
283
284
284
285
{% include
285
286
image.html
@@ -298,7 +299,7 @@ For how-to, see [Create a Git Source](#create-a-git-source).
298
299
|**Type**| The type of Git Source to create. {::nomarkdown}<ul><li><b>Standard Git Source</b>: The Git Source is created as an Argo CD Application in the Runtime's namespace, and belongs to the default or user-defined Application Project without deployment and repo restrictions.</li><li><b>Restricted Git Source</b>: The Git Source is created as an Argo CD application also in the Runtime's namespace, and belongs to the Application Projects created and automatically assigned by Codefresh. Applications synced with a Restricted Git Source must belong to the same Application Project and can deploy only to allowed clusters and namespaces.</li></ul>{:/}|
299
300
|**Source**| The Git repository where the application manifests, including that of the Git Source application, are stored. {::nomarkdown}<ul><li><b>Repository</b>: Mandatory. The URL of the Git repo.</li><li><b>Branch</b>: Optional. The specific branch within the repo in which to create the Git Source application manifest.</li><li><b>Path</b>: Optional. The specific path within the repo, and branch if one is specified, in which to create the Git Source application manifest.</li></ul>{:/}|
300
301
|**Include Files** and**Exclude Files**|The file or files to include or exclude from the Git repo when syncing to the destination cluster. <br>Use GLOB to define patterns using wildcards to match path names in the source Git repo. <br><br>For example,`workflows/**/*.yaml`, in the Include Files field would include all files in the`workflows` directory and all its child directories, with`.yaml` as the extension. <br><br>`**/images/**/*` in the Exclude Files field, would ignore all directories entitled`images`. <br>For GLOB guidelines and examples, see this[article](https://deepsource.io/blog/glob-file-patterns/){:target="\_blank"}.|
301
-
|**SourceNamespace**| Applies to Restricted Git Sources only. <br>The namespace in the cluster to which to deploy the manifests of Argo CD applications synced with this Git Source.<br>If the namespace doesn't exist on the clusterwith Argo CD, Codefresh automatically creates it.|
302
+
|**Namespace**| Applies to Restricted Git Sources only. <br>The namespace in the cluster to which to deploy the manifests of Argo CD applications synced with this Git Source, and_must start_ with the prefix`cf-`.<br>If the namespace doesn't exist on the cluster, Codefresh automatically creates it. <br><br>These namespaces are added to the configmap`argocd-cmd-params-cm` in`data.application.namespaces` as`cf-*`. You can define a different prefix for the namespaces by replacing`cf`withyour preferred prefix,`<prefix>-*` and use that prefix in Restricted Git Sources.Argo CD monitors these additional namespaces for application reconciliation.|
302
303
| **Application Project Scope** | Applies to Restricted Git Sources only. <br>The destination clusters and namespaces to which the applications synced to the Git Source and belonging to this Application Project can be deployed, and the trusted Git repos for the applications.{::nomarkdown}<ul><li><b>Allowed clusters and namespaces</b>: Single or multiple pairs of predefined clusters and namespaces to which applications belonging to the Application Project can be deployed. <br>For example, specifying a cluster-namespace pair <code class="highlighter-rouge">codefresh-production/game-apps:marvel-apps</code> will deploy the applications only to the defined cluster and namespace.<br>You can add multiple namespaces to the cluster-namespace pair. <br><br>You can also use pattern matching for clusters and namespaces with the <code class="highlighter-rouge">* </code> wildcard for broad matching. For example, <code class="highlighter-rouge">marvel-apps*</code> as the namespace would include the <code class="highlighter-rouge">marvel-apps-asia</code>, <code class="highlighter-rouge">marvel-apps-eu</code>, and <code class="highlighter-rouge">marvel-apps-us</code> namespaces. </li><li><b>Allowed Git Repos</b>: One or more trusted Git repositories for Argo CD applications synced to this Restricted Git Source. An Argo CD application that references a repository not in the trusted list is not synced to the Source Namespace in the cluster.</li></ul>{:/}|
303
304
304
305
@@ -307,7 +308,7 @@ For how-to, see [Create a Git Source](#create-a-git-source).
307
308
Drill down on a GitOps Runtime in List View to see its Git Sources.
308
309
309
310
1. In the Codefresh UI, go to the[GitOps Runtimes](https://g.codefresh.io/2.0/account-settings/runtimes){:target="\_blank"} page.
310
-
1. From the**List View** (the default),select a Runtime name, and then select the**Git Sources** tab.
311
+
1. From the**List View** (the default),click a Runtime name, and then select the**Git Sources** tab.
311
312
312
313
{% include
313
314
image.html
@@ -414,7 +415,7 @@ metadata:
414
415
namespace: runtime
415
416
spec:
416
417
destinations: # destination clusters and namespaces allowed by the Application Project
417
-
- namespace: hulk-apps-zone
418
+
- namespace:cf-hulk-apps-zone
418
419
server:https://kubernetes.default.svc
419
420
source: # source repos for the Git Source and other Argo CD Applications