canmove, Confirmed users, Bureaucrats and Sysops emeriti
1,093
edits
Labs/Bespin/UserGuide: Difference between revisions
Jump to navigation
Jump to search
→Version Control
| Line 96: | Line 96: | ||
===Version Control=== | ===Version Control=== | ||
Bespin is able to use a version control system (VCS) to keep track of the history of your project's files. Using Bespin in conjunction with an external VCS is also a great way to get files in and out of a Bespin server. | |||
====The Basics==== | |||
Bespin currently supports the Mercurial distributed VCS. You can add version control to a project using the command {{{hg init}}}. If you have never used a distributed VCS before, you might consider reading the [[http://en.wikipedia.org/wiki/Distributed_revision_control|Wikipedia article on the subject]]. | |||
If you are starting to use Bespin with an existing project, you can //clone// a remote repository. | |||
====Securely accessing remote systems==== | |||
In order to access remote VCSes, Bespin stores your login information for those remote systems in a private **keychain**. Your keychain file is encrypted with a password that is distinct from your login password and that you will need to type in whenever Bespin is accessing the remote system. Using a distributed VCS, you don't need to type this password in often. | |||
Bespin supports username and password-based access to remote systems. It can also use SSH, and Bespin will generate a public/private keypair that you can use on the remote system. The private key is stored in your keychain. You can get your public key using the command: | |||
{{{ | |||
vcs getkey | |||
}}} | |||
If your remote repository is at a site like [[http://bitbucket.org|Bitbucket]], it is easy to copy and paste this public key into the web interface of the site to get read and write access to your repositories from Bespin. | |||
====VCS Commands==== | |||
For security reasons, Bespin supports only a subset of VCS operations. We plan to expand the number of commands and VCSes supported over time. | |||
====vcs clone==== | |||
The clone command will clone (or check out) a remote repository. This command provides an interface for entering the different parameters needed to get set up. Since clone provides access to remote resources, you will need to enter your keychain password. | |||
Additionally, you need to tell where Bespin where to find the remote repository. | |||
(more to come) | |||
==File View== | ==File View== | ||