src/docs/user/userguide/diffusion_existing.diviner

   1 @title Diffusion User Guide: Existing Repositories
   2 @group userguide
   3
   4 Quick guide for importing or observing existing repositories.
   5
   6
   7 Overview
   8 ========
   9
  10 If you have an existing repository, you can observe or import it into
  11 Diffusion.
  12
  13 Observing a repository creates a read-only copy in Phabricator that is kept
  14 up to date by continuously importing new changes.
  15
  16 Importing a repository creates a read-write copy.
  17
  18 This document is a quick guide to getting started. For an overview of
  19 Diffusion, see @{article:Diffusion User Guide}. For a more detailed guide
  20 about managing repositories and URIs in Diffusion, see
  21 @{article:Diffusion User Guide: URIs}.
  22
  23
  24 Observing Repositories
  25 ======================
  26
  27 To observe an existing repository:
  28
  29   - Create a repository in Diffusion, but do not activate it yet.
  30   - Add the URI for the existing repository you wish to observe in the
  31     **URIs** section, in **Observe** mode.
  32   - Activate the repository in Diffusion.
  33
  34 This creates a read-only copy of the repository in Phabricator. Phabricator
  35 will keep its copy in sync with the remote by periodically polling the remote
  36 for changes.
  37
  38 For more details, see @{article:Diffusion User Guide: URIs}.
  39
  40
  41 Importing Repositories
  42 ======================
  43
  44 There are two primary ways to import an existing repository:
  45
  46 **Observe First**: In Git or Mercurial, you can observe the repository first.
  47 Once the import completes, change the "I/O Type" on the **Observe** URI to
  48 "No I/O" mode to automatically convert it into a hosted repository.
  49
  50 **Push to Empty Repository**: Create and activate an empty repository, then push
  51 all of your changes to the empty repository.
  52
  53 In Git and Mercurial, you can do this with `git push` or `hg push`.
  54
  55 In Subversion, you can do this with `svnsync`.
  56
  57 For more details, see @{article:Diffusion User Guide: URIs}.
  58
  59
  60 Next Steps
  61 ==========
  62
  63 Continue by:
  64
  65   - reading an overview of Diffusion in
  66     @{article:Diffusion User Guide}; or
  67   - learning more about managing remote repository URIs in
  68     @{article:Diffusion User Guide: URIs}.