Something went wrong. Try again.
@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.) hq.recaptime.dev/wiki/Phorge
phorge phabricator
Something went wrong. Try again.
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495@title Diffusion User Guide@group userguideGuide to Diffusion, the Phorge application for hosting and browsingrepositories.Overview========Diffusion allows you to create repositories so that you can browse them fromthe web and interact with them from other applications.Diffusion can host repositories locally, or observe existing remoterepositories which are hosted elsewhere (for example, on GitHub, Bitbucket, orother existing hosting). Both types of repositories can be browsed andinteracted with, but hosted repositories support some additional triggersand access controls which are not available for observed repositories.Diffusion is integrated with the other tools in the Phorge suite. Forinstance: - when you commit Differential revisions to a tracked repository, they are automatically updated and linked to the corresponding commits; - you can add Herald rules to notify you about commits that match certain rules; - for hosted repositories, Herald can enforce granular access control rules; - in all the tools, commit names are automatically linked.The remainder of this document walks through creating, configuring, andmanaging repositories.Adding Repositories===================Repository administration is accomplished through Diffusion. You can use theweb interface in Diffusion to observe an external repository or create a newhosted repository. - For hosted repositories, make sure you go through the setup instructions in @{article:Diffusion User Guide: Repository Hosting} first. - For all repositories, you'll need to be running the daemons. If you have not set them up yet, see @{article:Managing Daemons with phd}.By default, you must be an administrator to create a new repository. You canchange this in the application settings.Managing Repositories=====================Diffusion repositories have an array of configurable options and behaviors. Fordetails on the available options and guidance on managing and administratingrepositories, see @{article:Diffusion User Guide: Managing Repositories}.Repositories can also be managed via the API. For an overview on using theAPI to create and edit repositories, see@{article:Diffusion User Guide: Repositories API}.Repository Clustering=====================Phorge repository hosts can be set up in a cluster configuration so youcan lose hosts with minimal downtime and data loss. This is an advanced featurewhich most installs do not need to pursue.To get started with clustering, see @{article:Clustering Introduction}. Fordetails on repository clustering, see @{article:Cluster: Repositories}.Next Steps==========Continue by: - learning how to creating a symbol index at @{article:Diffusion User Guide: Symbol Indexes}; or - setting up repository hosting with @{article:Diffusion User Guide: Repository Hosting}; or - managing repository hooks with @{article:Diffusion User Guide: Commit Hooks}; or - understanding daemons in more detail with @{article:Managing Daemons with phd}.If you're having trouble getting things working, these topic guides may behelpful: - get details about automatically taking actions in response to commits in @{article:Diffusion User Guide: Permanent Refs}; or - understand how Phorge updates repositories with @{article:Diffusion User Guide: Repository Updates}; or - fix issues with repository imports with @{article:Troubleshooting Repository Imports}.