mirror of
https://we.phorge.it/source/phorge.git
synced 2025-01-07 13:21:02 +01:00
a763f9510e
Summary: Ref T182. Ref T9252. - Adds a "Test" repository operation that just runs `git status` to see if things work. - Adds a button for it in Edit Repository. - Shows operation status on the operation detail view to make this workflow work a little better. - Adds a lot of words. Words words words words. Test Plan: - Tested repository operation. - Read words. Reviewers: chad Reviewed By: chad Maniphest Tasks: T182, T9252 Differential Revision: https://secure.phabricator.com/D14349
53 lines
1.9 KiB
Text
53 lines
1.9 KiB
Text
@title Differential User Guide: Automated Landing
|
|
@group userguide
|
|
|
|
Configuring Phabricator so you can "Land Revision" from the web UI.
|
|
|
|
|
|
Overview
|
|
========
|
|
|
|
IMPORTANT: This feature is a prototype and has substantial limitations.
|
|
|
|
Phabricator can be configured so that approved revisions may be published
|
|
directly from the web interface. This can make publishing changes more
|
|
convenient, particularly for open source projects where authors may not have
|
|
commit access to the repository. This document explains the workflow and how to
|
|
configure it.
|
|
|
|
When properly configured, a {nav Land Revision} action will appear in
|
|
Differential. This action works like `arc land` on the command line, and
|
|
merges and publishes the revision.
|
|
|
|
This feature has significant limitations:
|
|
|
|
- This feature is a prototype.
|
|
- This feature is only supported in Git.
|
|
- This feature always lands changes onto `master`.
|
|
- This feature does not currently provide chain of custody, and what lands
|
|
may be arbitrarily different than what is shown in Differential.
|
|
|
|
To be landable, a revision must satisfy these requirements:
|
|
|
|
- It must belong to a repository which is tracked in Diffusion
|
|
(both hosted and imported repositories will work).
|
|
- The repository must have a **Staging Area** configured.
|
|
- The repository must have **Repository Automation** configured. For
|
|
details, see @{article:Drydock User Guide: Repository Automation}.
|
|
- The revision must have been created with `arc diff` and pushed to the
|
|
configured staging area at creation time.
|
|
- The user clicking the "Land Revision" button must have permission to push
|
|
to the repository.
|
|
|
|
If these requirements are met, the {nav Land Revision} action should be
|
|
available in the UI.
|
|
|
|
|
|
Next Steps
|
|
==========
|
|
|
|
Continue by:
|
|
|
|
- configuring repository automation with
|
|
@{article:Drydock User Guide: Repository Automation}; or
|
|
- returning to the @{article:Differential User Guide}.
|