Changeset View
Changeset View
Standalone View
Standalone View
src/docs/user/userguide/diffusion.diviner
@title Diffusion User Guide | @title Diffusion User Guide | ||||
@group userguide | @group userguide | ||||
Guide to Diffusion, the Phabricator application for hosting and browsing | Guide to Diffusion, the Phorge application for hosting and browsing | ||||
repositories. | repositories. | ||||
Overview | Overview | ||||
======== | ======== | ||||
Diffusion allows you to create repositories so that you can browse them from | Diffusion allows you to create repositories so that you can browse them from | ||||
the web and interact with them from other applications. | the web and interact with them from other applications. | ||||
Diffusion can host repositories locally, or observe existing remote | Diffusion can host repositories locally, or observe existing remote | ||||
repositories which are hosted elsewhere (for example, on GitHub, Bitbucket, or | repositories which are hosted elsewhere (for example, on GitHub, Bitbucket, or | ||||
other existing hosting). Both types of repositories can be browsed and | other existing hosting). Both types of repositories can be browsed and | ||||
interacted with, but hosted repositories support some additional triggers | interacted with, but hosted repositories support some additional triggers | ||||
and access controls which are not available for observed repositories. | and access controls which are not available for observed repositories. | ||||
Diffusion is integrated with the other tools in the Phabricator suite. For | Diffusion is integrated with the other tools in the Phorge suite. For | ||||
instance: | instance: | ||||
- when you commit Differential revisions to a tracked repository, they are | - when you commit Differential revisions to a tracked repository, they are | ||||
automatically updated and linked to the corresponding commits; | automatically updated and linked to the corresponding commits; | ||||
- you can add Herald rules to notify you about commits that match certain | - you can add Herald rules to notify you about commits that match certain | ||||
rules; | rules; | ||||
- for hosted repositories, Herald can enforce granular access control rules; | - for hosted repositories, Herald can enforce granular access control rules; | ||||
- in all the tools, commit names are automatically linked. | - in all the tools, commit names are automatically linked. | ||||
Show All 28 Lines | |||||
Repositories can also be managed via the API. For an overview on using the | Repositories can also be managed via the API. For an overview on using the | ||||
API to create and edit repositories, see | API to create and edit repositories, see | ||||
@{article:Diffusion User Guide: Repositories API}. | @{article:Diffusion User Guide: Repositories API}. | ||||
Repository Clustering | Repository Clustering | ||||
===================== | ===================== | ||||
Phabricator repository hosts can be set up in a cluster configuration so you | Phorge repository hosts can be set up in a cluster configuration so you | ||||
can lose hosts with minimal downtime and data loss. This is an advanced feature | can lose hosts with minimal downtime and data loss. This is an advanced feature | ||||
which most installs do not need to pursue. | which most installs do not need to pursue. | ||||
To get started with clustering, see @{article:Clustering Introduction}. For | To get started with clustering, see @{article:Clustering Introduction}. For | ||||
details on repository clustering, see @{article:Cluster: Repositories}. | details on repository clustering, see @{article:Cluster: Repositories}. | ||||
Next Steps | Next Steps | ||||
Show All 10 Lines | Continue by: | ||||
- understanding daemons in more detail with | - understanding daemons in more detail with | ||||
@{article:Managing Daemons with phd}. | @{article:Managing Daemons with phd}. | ||||
If you're having trouble getting things working, these topic guides may be | If you're having trouble getting things working, these topic guides may be | ||||
helpful: | helpful: | ||||
- get details about automatically taking actions in response to commits in | - get details about automatically taking actions in response to commits in | ||||
@{article:Diffusion User Guide: Permanent Refs}; or | @{article:Diffusion User Guide: Permanent Refs}; or | ||||
- understand how Phabricator updates repositories with | - understand how Phorge updates repositories with | ||||
@{article:Diffusion User Guide: Repository Updates}; or | @{article:Diffusion User Guide: Repository Updates}; or | ||||
- fix issues with repository imports with | - fix issues with repository imports with | ||||
@{article:Troubleshooting Repository Imports}. | @{article:Troubleshooting Repository Imports}. |
Content licensed under Creative Commons Attribution-ShareAlike 4.0 (CC-BY-SA) unless otherwise noted; code licensed under Apache 2.0 or other open source licenses. · CC BY-SA 4.0 · Apache 2.0