Skip to content

Commit d191408

Browse files
authored
notes about data location policy (github#26495)
1 parent 72c291b commit d191408

File tree

2 files changed

+9
-1
lines changed

2 files changed

+9
-1
lines changed

content/admin/enterprise-management/caching-repositories/about-repository-caching.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,6 @@ A repository cache eliminates the need for {% data variables.product.product_nam
1616

1717
The repository cache listens to the primary instance, whether that's a single instance or a geo-replicated set of instances, for changes to Git data. CI farms and other read-heavy consumers clone and fetch from the repository cache instead of the primary instance. Changes are propagated across the network, at periodic intervals, once per cache instance rather than once per client. Git data will typically be visible on the repository cache within several minutes after the data is pushed to the primary instance. {% ifversion ghes > 3.3 %}The [`cache_sync` webhook](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#cache_sync) can be used by CI systems to react to data being available in the cache.{% endif %}
1818

19-
You have fine-grained control over which repositories are allowed to sync to the repository cache.
19+
You have fine-grained control over which repositories are allowed to sync to the repository cache. Git data will only be replicated to the locations you specify.
2020

2121
{% data reusables.enterprise.repository-caching-config-summary %} For more information, see "[Configuring a repository cache](/admin/enterprise-management/caching-repositories/configuring-a-repository-cache)."

content/admin/enterprise-management/caching-repositories/configuring-a-repository-cache.md

+8
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,14 @@ Then, when told to fetch `https://github.example.com/myorg/myrepo`, Git will ins
6969

7070
You can control data locality by configuring data location policies for your repositories with the `spokesctl cache-policy` command. Data location policies determine which repository networks are replicated on which repository caches. By default, no repository networks will be replicated on any repository caches until a data location policy is configured.
7171

72+
Data location policies affect only Git content. Content in the database, such as issues and pull request comments, will be replicated to all nodes regardless of policy.
73+
74+
{% note %}
75+
76+
**Note:** Data location policies are not the same as access control. You must use repository roles to control which users may access a repository. For more information about repository roles, see "[Repository roles for an organization](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)."
77+
78+
{% endnote %}
79+
7280
You can configure a policy to replicate all networks with the `--default` flag. For example, this command will create a policy to replicate a single copy of every repository network to the set of repository caches whose `cache_location` is "kansas".
7381

7482
```

0 commit comments

Comments
 (0)