Skip to content

Commit 3febda4

Browse files
committed
fix: update changes to docs
1 parent 6673cab commit 3febda4

File tree

1 file changed

+11
-26
lines changed
  • docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/installation

1 file changed

+11
-26
lines changed

docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/installation/installation.mdx

Lines changed: 11 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -34,37 +34,22 @@ Starting from **version 3.0.0-beta**, the GitHub integration supports syncing da
3434
- GitHub App and fine-grained PAT: use `githubOrganization` (single organization).
3535
- Classic PAT:
3636
- To sync multiple organizations, list them in your port mapping under `organizations`.
37+
38+
```yaml showLineNumbers
39+
deleteDependentEntities: true
40+
createMissingRelatedEntities: true
41+
enableMergeEntity: true
42+
organizations:
43+
- org1
44+
- org2
45+
# ... rest of your mapping (repositoryType, resources, etc.) ...
46+
```
47+
3748
- If `organizations` are not specified, the integration will sync all organizations the classic PAT is scoped to.
3849
- Precedence: if `githubOrganization` is set in the environment variables or config and `organizations` are listed in port mapping, the integration syncs only the `githubOrganization` (single‑org behavior).
3950
- Performance: syncing multiple organizations increases API calls and may slow down the integration.
4051
:::
4152

42-
#### Cleanup after restricting organizations
43-
44-
If you initially synced multiple organizations (e.g., on a first‑time install before your mapping was ready) and later restrict organizations in your mapping, set `entityDeletionThreshold: 1` temporarily and resync to ensure previously ingested, now‑unwanted entities are deleted. Revert the threshold afterwards (default ≈ 0.9) or remove completely.
45-
46-
<details>
47-
<summary><b>Entity deletion threshold (click to expand)</b></summary>
48-
49-
```yaml showLineNumbers
50-
51-
entityDeletionThreshold: 1
52-
resources:
53-
- kind: organization
54-
selector:
55-
query: 'true'
56-
port:
57-
entity:
58-
mappings:
59-
identifier: .login
60-
title: .login
61-
blueprint: '''githubOrganization'''
62-
properties:
63-
login: .login
64-
id: .id
65-
```
66-
</details>
67-
6853
### Create access token
6954

7055
To allow Port to fetch data from your GitHub Organization(s), you need to create an access token. Port supports two types of tokens for authentication: personal access tokens and GitHub app installation tokens.

0 commit comments

Comments
 (0)