Differential D15861 Diff 38206 src/docs/user/userguide/diffusion_uris.diviner

Changeset View

Standalone View

src/docs/user/userguide/diffusion_uris.diviner

	Show All 17 Lines
	configuration, and similar to repositories on other services like GitHub or			configuration, and similar to repositories on other services like GitHub or
	Bitbucket.			Bitbucket.

	Observe Repositories: Phabricator can create a copy of an repository which			Observe Repositories: Phabricator can create a copy of an repository which
	is hosted elsewhere (like GitHub or Bitbucket) and track updates to the remote			is hosted elsewhere (like GitHub or Bitbucket) and track updates to the remote
	repository. This will create a read-only copy of the repository in Phabricator.			repository. This will create a read-only copy of the repository in Phabricator.

	Mirror Repositories: Phabricator can publish any repository to mirrors,			Mirror Repositories: Phabricator can publish any repository to mirrors,
	updating the mirrors as changes are made to the repository. This works with			overwiting them with an exact copy of the repository that stays up to date as
	both local hosted repositories and remote repositories that Phabricator is			the source changes. This works with both local repositories that Phabricator is
	observing.			hosting and remote repositories that Phabricator is observing.

	Proxy Repositories: If you are observing a repository, you can allow users			Proxy Repositories: If you are observing a repository, you can allow users
	to read Phabricator's copy of the repository. Phabricator supports granular			to read Phabricator's copy of the repository. Phabricator supports granular
	read permissions, so this can let you open a private repository up a little			read permissions, so this can let you open a private repository up a little
	bit in a flexible way.			bit in a flexible way.

	Import Repositories: If you have a repository elsewhere that you want to			Import Repositories: If you have a repository elsewhere that you want to
	host on Phabricator, you can observe the remote repository first, then turn			host on Phabricator, you can observe the remote repository first, then turn
	▲ Show 20 Lines • Show All 60 Lines • ▼ Show 20 Lines


	Mirror a Repository			Mirror a Repository
	===================			===================

	NOTE: Mirroring is not supported in Subversion.			NOTE: Mirroring is not supported in Subversion.

	You can create a read-only mirror of an existing repository. Phabricator will			You can create a read-only mirror of an existing repository. Phabricator will
	push all changes made to the repository to the mirror.			continuously publish the state of the source repository to the mirror, creating
				an exact copy.

	For example, if you have a repository hosted in Phabricator that you want to			For example, if you have a repository hosted in Phabricator that you want to
	mirror to GitHub, you can configure Phabricator to automatically maintain the			mirror to GitHub, you can configure Phabricator to automatically maintain the
	mirror. This is how the upstream repositories are set up.			mirror. This is how the upstream repositories are set up.

				The mirror copy must be read-only for users because any writes made to the
				mirror will be undone when Phabricator updates it. The mirroring process copies
				the entire repository state exactly, so the remote state will be completely
				replaced with an exact copy of the source repository. This may remove or
				destroy information. Normally, you should only mirror to an empty repository.

	You can mirror any repository, even if Phabricator is only observing it and not			You can mirror any repository, even if Phabricator is only observing it and not
	hosting it directly.			hosting it directly.

	To begin mirroring a repository:			To begin mirroring a repository:

	- Create a hosted or observed repository by following the relevant			- Create a hosted or observed repository by following the relevant
	instructions above.			instructions above.
	- Add the remote URI you want to mirror to as a repository URI.			- Add the remote URI you want to mirror to as a repository URI.
	▲ Show 20 Lines • Show All 157 Lines • Show Last 20 Lines