Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
wiki:руководство_по_ubuntu_server:система_управления_версиями:subversion [2012/09/03 20:35] [Методы доступа] |
wiki:руководство_по_ubuntu_server:система_управления_версиями:subversion [2012/09/04 09:37] (текущий) [Методы доступа] |
||
---|---|---|---|
Строка 46: | Строка 46: | ||
В этом разделе мы рассмотрим как настроить Subversion для всех этих методов доступа. Здесь мы рассмотрим основное. Для более продвинутого использования, обратитесь к книге [[http://svnbook.red-bean.com/|svn book]]. | В этом разделе мы рассмотрим как настроить Subversion для всех этих методов доступа. Здесь мы рассмотрим основное. Для более продвинутого использования, обратитесь к книге [[http://svnbook.red-bean.com/|svn book]]. | ||
- | ===Direct repository access (file://)=== | + | ===Прямой доступ к хранилищу (file://)=== |
- | Это самый простой из всех методов доступа. Он не требует запуска какого-либо сервера Subversion. Этот метод использует для доступа Subversion на этой же машине. Синтаксис команды, вводимой в терминале, аналогичен следующему: | + | Это самый простой из всех методов доступа. Он не требует запуска какого-либо сервера Subversion. Этот метод используется для доступа к Subversion на этой же машине. Синтаксис команды, вводимой в терминале, аналогичен следующему: |
<code>svn co file:///path/to/repos/project</code> | <code>svn co file:///path/to/repos/project</code> | ||
или | или | ||
<code>svn co file://localhost/path/to/repos/project</code> | <code>svn co file://localhost/path/to/repos/project</code> | ||
- | <note>Если вы не указываете сетевое имя, требуется три прямых слеша (%%///%%) - два для обозначения протокола (в данном случае - file), плюс лидирующий слеш в адресе. Если вы указываете сетевое имя, вы должны указать два слеша (%%//%%).</note> | + | <note>Если вы не указываете сетевое имя, требуется три прямых слеша в начале адреса (%%///%%) - два для обозначения протокола (в данном случае - file), плюс лидирующий слеш базового каталога. Если вы указываете сетевое имя, вы должны указать два слеша (%%//%%).</note> |
Права доступа к хранилищу определяются правами файловой системы. Если пользователь имеет право на чтение/запись, он может получить содержимое хранилища и внести изменения. | Права доступа к хранилищу определяются правами файловой системы. Если пользователь имеет право на чтение/запись, он может получить содержимое хранилища и внести изменения. | ||
Строка 91: | Строка 91: | ||
Доступ к хранилищу Subversion по протоколу WebDAV с SSL шифрованием (%%https://%%) аналогичен %%http://%% за исключением что вы должны установить и настроить цифровой сертификат для вашего Apache2 сервера. Для использования SSL с Subversion добавьте конфигурацию приведенную выше в файл /etc/apache2/sites-available/default-ssl. Для дополнительной информации по установке Apache2 с SSL смотрите [[wiki:руководство_по_ubuntu_server:web_сервера:httpd_apache2_web_server#настройка_https|настройку HTTPS]]. | Доступ к хранилищу Subversion по протоколу WebDAV с SSL шифрованием (%%https://%%) аналогичен %%http://%% за исключением что вы должны установить и настроить цифровой сертификат для вашего Apache2 сервера. Для использования SSL с Subversion добавьте конфигурацию приведенную выше в файл /etc/apache2/sites-available/default-ssl. Для дополнительной информации по установке Apache2 с SSL смотрите [[wiki:руководство_по_ubuntu_server:web_сервера:httpd_apache2_web_server#настройка_https|настройку HTTPS]]. | ||
+ | Вы можете установить цифровой сертификат, выпущенный центром сертификации. В качестве альтернативы можно использовать самоподписанный сертификат. | ||
- | You can install a digital certificate issued by a signing authority. Alternatively, you can install your own self-signed certificate. | + | Эта часть подразумевает, что вы установили и настроили цифровой сертификат в вашем сервере Apache2. Теперь чтобы получить доступ к хранилищу Subversion смотрите предыдущий раздел. Метод доступа практически тот же самый, за исключением протокола. Вы должны использовать %%https://%% для доступа к хранилищу Subversion. |
- | This step assumes you have installed and configured a digital certificate in your Apache 2 web server. Now, to access the Subversion repository, please refer to the above section! The access methods are exactly the same, except the protocol. You must use https:// to access the Subversion repository. | + | ===Доступ через собственный протокол (svn://)=== |
- | + | ||
- | ===Access via custom protocol (svn://)=== | + | |
- | + | ||
- | Once the Subversion repository is created, you can configure the access control. You can edit the /path/to/repos/project/conf/svnserve.conf file to configure the access control. For example, to set up authentication, you can uncomment the following lines in the configuration file: | + | |
+ | Как только создано хранилище Subversion, вы можете настроить контроль доступа. Вы можете отредактировать файл /path/to/repos/project/conf/svnserve.conf для изменения контроля доступа. Например, для установки авторизации вы можете раскомментировать следующие строки в файле конфигурации: | ||
+ | <code> | ||
# [general] | # [general] | ||
# password-db = passwd | # password-db = passwd | ||
+ | </code> | ||
- | After uncommenting the above lines, you can maintain the user list in the passwd file. So, edit the file passwd in the same directory and add the new user. The syntax is as follows: | + | После снятия знака комментария (#) с этих строк, вы можете поддерживать список пользователей в файле passwd. И так, редактируйте файл passwd в этом же каталоге и добавляйте новых пользователей. Синтаксис должен быть таким: |
- | + | <code>username = password</code> | |
- | username = password | + | Более подробно смотрите комментарии в самом файле. |
- | + | ||
- | For more details, please refer to the file. | + | |
- | + | ||
- | Now, to access Subversion via the svn:// custom protocol, either from the same machine or a different machine, you can run svnserver using svnserve command. The syntax is as follows: | + | |
+ | Теперь, чтобы подключиться к Subversion через собственный протокол %%svn://%%, с этой же машины или другой, вы можете запустить **svnserver** с помощью команды **svnserve**. Синтаксис следующий: | ||
+ | <code> | ||
$ svnserve -d --foreground -r /path/to/repos | $ svnserve -d --foreground -r /path/to/repos | ||
- | # -d -- daemon mode | + | # -d - режим сервиса |
- | # --foreground -- run in foreground (useful for debugging) | + | # --foreground - запуск в фоновом режиме (полезно при отладке) |
- | # -r -- root of directory to serve | + | # -r - корневой каталог для обслуживания |
- | + | </code> | |
- | For more usage details, please refer to: | + | <note>Больше деталей по использованию можно посмотреть, выполнив команду: |
- | $ svnserve --help | + | <code>$ svnserve --help</code></note> |
- | + | ||
- | Once you run this command, Subversion starts listening on default port (3690). To access the project repository, you must run the following command from a terminal prompt: | + | |
- | + | ||
- | svn co svn://hostname/project project --username user_name | + | |
- | + | ||
- | Based on server configuration, it prompts for password. Once you are authenticated, it checks out the code from Subversion repository. To synchronize the project repository with the local copy, you can run the update sub-command. The syntax of the command, entered at a terminal prompt, is as follows: | + | |
- | + | ||
- | cd project_dir ; svn update | + | |
- | + | ||
- | For more details about using each Subversion sub-command, you can refer to the manual. For example, to learn more about the co (checkout) command, please run the following command from a terminal prompt: | + | |
- | + | ||
- | svn co help | + | |
- | ===Access via custom protocol with SSL encryption (svn+ssh://)=== | + | Как только вы выполните указанную команду, Subversion запустится на порту по умолчанию (3690). Для доступа к хранилищу проектов вам потребуется выполнить следующую команду из терминала: |
+ | <code>svn co svn://hostname/project project --username user_name</code> | ||
+ | Основываясь на конфигурации сервера, у вас будет запрошен пароль. После аутентификации будет проверен код из хранилища Subversion. Для синхронизации проекта из хранилища с локальной копией вам потребуется выполнить подкоманду update. Синтаксис команды, вводимой в терминале следующий: | ||
+ | <code>cd project_dir ; svn update</code> | ||
- | The configuration and server process is same as in the svn:// method. For details, please refer to the above section. This step assumes you have followed the above step and started the Subversion server using svnserve command. | + | Для подробной информации о каждой подкоманде Subversion вы можете обратиться к встроенному руководству. Например, чтобы узнать больше о команде co (checkout) выполните следующую команду в терминале: |
+ | <code>svn co help</code> | ||
- | It is also assumed that the ssh server is running on that machine and that it is allowing incoming connections. To confirm, please try to login to that machine using ssh. If you can login, everything is perfect. If you cannot login, please address it before continuing further. | + | ===Доступ по собственному протоколу с SSL шифрованием (svn+ssh://)=== |
- | The svn+ssh:// protocol is used to access the Subversion repository using SSL encryption. The data transfer is encrypted using this method. To access the project repository (for example with a checkout), you must use the following command syntax: | + | Настройка и работа сервера такая же, как при %%svn://%% методе. Детали описаны в предыдущей части.Этот шаг предполагает, что вы следовали инструкциям предыдущей части и запустили сервер Subversion с помощью команды svnserve. |
- | svn co svn+ssh://hostname/var/svn/repos/project | + | Также предполагается, что у вас на машине запущен сервер ssh и он разрешает входящие соединения. Для проверки, пожалуйста, попробуйте войти на машину с использованием ssh. Если вам удалось соединиться, все замечательно. Если соединиться не получилось, обратитесь к данной проблеме, прежде чем следовать дальше. |
- | You must use the full path (/path/to/repos/project) to access the Subversion repository using this access method. | + | Протокол %%svn+ssh://%% используется для доступа к хранилищу Subversion с использованием SSL шифрования. Данные передаются шифрованными с использованием этого метода. Для доступа к проекту в хранилище (например, с командой checkout) вам нужно использовать следующую команду: |
+ | <code>svn co svn+ssh://hostname/var/svn/repos/project</code> | ||
+ | <note>Вы должны использовать полный путь (/path/to/repos/project) для доступа к хранилищу Subversion при этом методе подключения.</note> | ||
- | Based on server configuration, it prompts for password. You must enter the password you use to login via ssh. Once you are authenticated, it checks out the code from the Subversion repository. | + | Основываясь на настройках сервера, будет запрошен пароль. Вы должны будете ввести пароль, который используете при доступе через ssh. После аутентификации команда проверит код из хранилища Subversion. |
---- | ---- |