Это свершилось! Сегодня, 1 июля 2010 года, нам исполнилось 5 лет. Поздравляем всех участников проекта EasyCoding (действующих и бывших) с этим знаменательным событием.
За эти 5 лет было сделано достаточно много: разработано свыше 50 различных проектов, создана огромная база кода для внутреннего использования и т.д.
Всем участникам проекта сегодня необходимо посетить ауд. 116 в 17:00.
В своём предыдущем HOWTO, посвящённом установке и настройке SVN-сервера под Windows, я сознательно ничего не писал о разграничении прав пользователей репозитария, т.к. эта тема “тянет” на отдельную статью.
В этом HOWTO я подробно напишу как создать несколько пользователей и ограничить их полномочия в репозитарии (выделим каждому по каталогу, а также общий каталог).
Данное HOWTO будет разделено на два больших раздела: “Настройка svnserve” (если в качестве сервера Вы используете svnserve) и “Настройка Apache” (если в качестве сервера Вы используете Apache + mod_svn).
В любом текстовом редакторе (рекомендуется Notepad++) откройте файл ПУТЬ_К_РЕПОЗИТАРИЮ\conf\svnserve.conf и сделайте следующие правки. В базовых правах пропишите:
anon-access = none auth-access = write
Это запретит доступ анонимам и даст полный доступ авторизованным пользователям. Если всё-таки нужно дать доступ анонимам, то anon-access установите в read.
Раскомментируйте строку (уберите решётку перед строкой):
authz-db = authz
Эта строка включает функции, отвечающие за разграничение прав пользователей. Все настройки прав пользователей записываются в указанный здесь файл (в нашем примере – authz (без расширения)).
Остальные настройки файла svnserve.conf можно не изменять. Более подробную информацию об этом файле читайте в первом HOWTO.
Откройте в любом текстовом редакторе файл, который задан в файле svnserve.conf как файл со списком пользователей и их паролей в директиве password-db. По умолчанию этот файл называется passwd (без расширения).
Впишите в этот файл нужных Вам пользователей и их пароли (синтаксис логин = пароль). Более подробную информацию можно получить в первом HOWTO на шаге 3. Там же Вы можете посмотреть примеры такого файла.
Для удобства администрирования можно создать группы, но делать это не обязательно. Итак, если Вы хотите создать группы, откройте в любом текстовом редакторе файл authz (если Вы не сменили его название на шаге 1), найдите [groups] и после примеров впишите:
название_группы = пользователь1,пользователь2,...,пользовательN
Название группы должно содержать только латинские символы, цифры и символ подчёркивания. После знака равенства пишутся логины пользователей, которые будут входить в эту группу. Эти логины должны существовать в файле passwd (если Вы не изменили его название на шаге 1), в противном случае (если Вы указали логины, которых нет в файле соответствия пользователей, сервер может не запуститься).
Рассмотрим достаточно простой пример:
[groups] admins = vova,vitaly proj1 = kate,john,bill,sam proj2 = dima,john
В этом примере мы создали три группы: admins (администраторы сервера), proj1 (группа, которая будет работать над проектом 1) и proj2 (группа, которая будет работать над проектом 2). Пользователь john в нашем примере входит в обе группы, т.е. имеет доступ как к проекту 1, так и к проекту 2.
На следующем шаге мы пропишем этим группам права доступа.
В том же текстовом файле authz, что и на предыдущем шаге, ищем “### ACCESS CONTROL SECTION“. После этой секции идёт указание прав доступа для каталогов svn-сервера. Разграничение прав лучше всего показать на примерах, поэтому представим что у нас на svn-сервере создана следующая структура каталогов:
/ /proj1/ /proj2/ /common/
Здесь нам нужно задать права:
Если у Вас на шаге 3 были созданы группы, то всё делается очень просто:
# Указываем корневой каталог [/ ] # Даём полный доступ группе админов @admins = rw # Блокируем доступ всем остальным * = # Указываем каталог проекта1 [/proj1] # Даём полный доступ админам @admins = rw # Даём полный доступ группе проекта1 @proj1 = rw # Блокируем доступ всем остальным * = # Указываем каталог проекта2 [/proj1] # Даём полный доступ админам @admins = rw # Даём полный доступ группе проекта2 @proj2 = rw # Блокируем доступ всем остальным * = # Указываем доступный для всех каталог common [/common] # Даём полный доступ админам @admins = rw # Даём доступ только чтение для всех * = r
Если группы созданы не были, то придётся вместо групп прописывать через запятую всех пользователей:
# Указываем корневой каталог [/ ] # Даём полный доступ админам vova,vitaly = rw # Блокируем доступ всем остальным * = # Указываем каталог проекта1 [/proj1] # Даём полный доступ админам vova,vitaly = rw # Даём полный доступ группе проекта1 kate,john,bill,sam = rw # Блокируем доступ всем остальным * = # Указываем каталог проекта2 [/proj1] # Даём полный доступ админам vova,vitaly = rw # Даём полный доступ группе проекта2 dima,john = rw # Блокируем доступ всем остальным * = # Указываем доступный для всех каталог common [/common] # Даём полный доступ админам vova,vitaly = rw # Даём доступ только чтение для всех * = r
Таким образом, rw означает полный доступ (чтение, создание, редактирование, удаление), r (только чтение) и пустая строка – нет доступа.
Внимание! Права для подкаталога применяются рекурсивно, но если для какого-то подкаталога заданы индивидуальные права доступа, то они переопределят глобальные. Например, если какой-то группе стоят полные права доступа на корневой каталог, а в /proj1/ стоит запрет для всех, то у этой группы доступа к каталогу не будет.
В любом текстовом редакторе откройте файл httpd.conf (основной файл конфигурации веб-сервера Apache). В самом конце файла найдите описание указание на Ваш каталог svn-проектов. Подробности настройки Apache + mod_svn читайте в первом HOWTO.
В конце файла httpd.conf найдите следующие строки:
DAV svn SVNParentPath C:\svn_repository
и замените на такие:
DAV svn SVNPath С:\svn_repository AuthzSVNAccessFile С:\svn_repository\conf\authz AuthType Basic AuthName "Subversion repository" AuthUserFile С:\svn_repository\conf\appswd Require valid-user
Здесь C:\svn_repository – это путь к каталогу репозитория (измените в соответствии с Вашими настройками), authz – файл настроек доступа, а appswd – файл с логинами и паролями пользователей (стандартный htpasswd-файл Apache).
Откройте командную строку Windows (“Win+R” – “cmd.exe“) и выполните следующие команды:
cd "%PROGRAMFILES%\CollabNet\Subversion Server\httpd\bin" htpasswd -cmb C:\svn_repository\conf\appswd ЛОГИН_ПОЛЬЗОВАТЕЛЯ_1 ПАРОЛЬ htpasswd -mb C:\svn_repository\conf\appswd ЛОГИН_ПОЛЬЗОВАТЕЛЯ_2 ПАРОЛЬ ... htpasswd -mb C:\svn_repository\conf\appswd ЛОГИН_ПОЛЬЗОВАТЕЛЯ_N ПАРОЛЬ
Здесь “%PROGRAMFILES%\CollabNet\Subversion Server\httpd\bin” – каталог установки сервера Apache + mod_svn (замените в соответствии с Вашими настройками), а “C:\svn_repository” – путь к локальному репозитарию (также измените в соответствии с настройками).
Внимание! Параметр -cm нужно указывать только при первом создании пользователя, т.к. он перезаписывает имеющийся файл. В пути к файлу паролей буква диска обязательно должна быть в верхнем регистре. Логин должен содержать только латинские буквы, символ подчёркивания и цифры. Пароль хранится в виде хэша MD5.
См. шаг 3 и 4 в разделе “Настройка svnserve” выше. Эти шаги одинаковы что для svnserve, что для Apache.
После окончания настройки не забудьте перезапустить свой сервер. Команды перезапуска для svnserve:
net stop CSVNsvnserve net start CSVNsvnserve
Команды перезапуска для Apache:
net stop CollabNetSubversionApache net start CollabNetSubversionApache
04 мая 2010 года была выпущена новая версия программы для настройки и восстановления TF2 – TF2 Repair 2.1 Final.
В версии 2.1 была исправлена работа программы после крупного обновления платформы Steam, исправлено несколько незначительных багов и добавлено несколько новых функций.
Полный список изменений версии 2.1 Final:
Скачать программу можно на её официальной странице, либо по следующим прямым ссылкам (по этим ссылкам всегда скачивается самая последняя версия программы):
Сообщения об ошибках этой версии просьба оставлять в комментариях либо к этому сообщению, либо на официальной странице. Мы стараемся исправить как можно быстрее все найденные в программе баги.
Всем пользователям предыдущих версий рекомендуем как можно скорее скачать версию 2.1 Final.
30 марта 2010 года, была выпущена новая версия программы для настройки и восстановления TF2 – TF2 Repair 2.0 Final (2.0.1 – 02.04.2010).
В версии 2.0.x было сделано множество изменений: полностью переработан Редактор конфигов, интерфейс которого теперь максимально прост и понятен любому пользователю, добавлена полная поддержка операционной системы Windows 7 (как 32-битной версии, так и 64-битной), добавлены обработчики всех возможных нештатных ситуаций, улучшена работа Службы восстановления Steam и многое другое.
Полный список изменений версии 2.0 Final:
Полный список изменений версии 2.0.1 Final:
Теперь TF2 Repair выпускается в двух версиях: с инсталлятором (по умолчанию) и в portable-версии (как раньше, в виде zip-архива, не требующего установки).
Скачать программу можно на её официальной странице, либо по следующим прямым ссылкам (по этим ссылкам всегда скачивается самая последняя версия программы):
Сообщения об ошибках этой версии просьба оставлять в комментариях либо к этому сообщению, либо на официальной странице. Мы стараемся исправить как можно быстрее все найденные в программе баги.
Всем пользователям предыдущих версий рекомендуем как можно скорее скачать версию 2.0.1.
В данном HOWTO я подробно опишу как установить и настроить SVN (subversion) сервер под ОС Windows.
Статья о настройке прав доступа SVN-сервера доступна здесь.
Итак, для начала нам будет нужен сам дистрибутив с svn-сервером, который можно бесплатно скачать с официального сайта CollabNet (перед тем как что-то скачать, Вы должны пройти бесплатную регистрацию на этом сайте (зачем так сделано не очень понятно)). Вы должны скачать CollabNet Subversion Server and Client v1.6.9 (for Windows) (версия 1.6.9 – последняя на момент написания данного HOWTO).
После скачивания файла CollabNetSubversion-server-1.6.9-1.win32.exe (18,44 МБ), запускайте его и следуйте указаниям мастера. Мастер выполнит несколько шагов. Рассмотрим все шаги мастера по порядку:
В качестве SVN-клиента мы будем использовать TortoiseSVN, подробнее о котором можно почитать в HOWTO.
Скачать программу можно на её официальном сайте программы на странице Downloads: http://tortoisesvn.net/downloads. Там же можно скачать пакет локализации, содержащий помимо перевода интерфейса программы, ещё и словарь проверки орфографии (применяется при коммите изменений).
Установка программы стандартна и не должна вызвать никаких сложностей.
Настройку начнём с того, что создадим новый репозитарий со стандартными настройками, которые и будем редактировать. Для этого зайдём в Проводнике Windows в каталог, указанный в качестве “Repository path” во время установки сервера (стандартное значение – С:\svn_repository\), нажмём правой кнопкой по пустому месту в нём и выберем “TortoiseSVN” – “Create repository here“. Через несколько мгновений внутри каталога появятся файлы и подкаталоги, а также будет выведено сообщение об успешном создании репозитария. В дальнейшем путь к репозитарию я буду заменять на ПУТЬ_К_РЕПОЗИТАРИЮ.
Теперь мы должны создать пользователей, которые будут работать с репозитарием. Для этого мы должны открыть файл “ПУТЬ_К_РЕПОЗИТАРИЮ\conf\svnserve.conf” в любом текстовом редакторе, например Блокноте Windows или Notepad++. Здесь Вы должны раскомментировать (убрать перед строкой символ(ы) “#“) следующие строки:
anon-access = none auth-access = write
Строка “anon-access = none” означает, что анонимы не смогут получить доступ к репозитарию вообще (сделано из соображений безопасности), а “auth-access = write” означает, что авторизованные пользователи получат полный доступ в пределах их ограничений, заданных в файле authz (если такая функция включена). Если Вы хотите, чтобы анонимы могли получить доступ только для чтения (например, разрабатываете OpenSource-проект), то установите “anon-access = read“.
Теперь Вы должны раскомментировать строку:
password-db = passwd
Эта строка указывает в каком файле будут находиться логины и пароли пользователей для авторизации на svn-сервере. Теперь откройте файл “ПУТЬ_К_РЕПОЗИТАРИЮ\conf\passwd” в любом текстовом редакторе и впишите в нём “логин_пользователя = пароль_пользователя” (разделителем служит знак равенства). Пример правильного файла passwd:
### This file is an example password file for svnserve. ### Its format is similar to that of svnserve.conf. As shown in the ### example below it contains one section labelled [users]. ### The name and password for each user follow, one account per line. [users] # harry = harryssecret # sally = sallyssecret vova = kjkj345K anton = Gh74oJId dima = ir9895498 katya = o894584578 sergey = 985kdfjdfk
Убираем символ комментария из строки:
realm = My First Repository
В ней указывается имя Вашего репозитария. После знака равенства вместо My First Repository Вы можете указать любое другое имя. Оно выводится при запросе логина и пароля.
Настройка сервера с простой (simple) авторизацией завершена. Пример правильного файла конфигурации сервера:
### This file controls the configuration of the svnserve daemon, if you ### use it to allow access to this repository. (If you only allow ### access through http: and/or file: URLs, then this file is ### irrelevant.) ### Visit http://subversion.tigris.org/ for more information. [general] ### These options control access to the repository for unauthenticated ### and authenticated users. Valid values are "write", "read", ### and "none". The sample settings below are the defaults. anon-access = none auth-access = write ### The password-db option controls the location of the password ### database file. Unless you specify a path starting with a /, ### the file's location is relative to the directory containing ### this configuration file. ### If SASL is enabled (see below), this file will NOT be used. ### Uncomment the line below to use the default password file. password-db = passwd ### The authz-db option controls the location of the authorization ### rules for path-based access control. Unless you specify a path ### starting with a /, the file's location is relative to the the ### directory containing this file. If you don't specify an ### authz-db, no path-based access control is done. ### Uncomment the line below to use the default authorization file. #authz-db = authz ### This option specifies the authentication realm of the repository. ### If two repositories have the same authentication realm, they should ### have the same password database, and vice versa. The default realm ### is repository's uuid. realm = Test Repository [sasl] ### This option specifies whether you want to use the Cyrus SASL ### library for authentication. Default is false. ### This section will be ignored if svnserve is not built with Cyrus ### SASL support; to check, run 'svnserve --version' and look for a line ### reading 'Cyrus SASL authentication is available.' # use-sasl = true ### These options specify the desired strength of the security layer ### that you want SASL to provide. 0 means no encryption, 1 means ### integrity-checking only, values larger than 1 are correlated ### to the effective key length for encryption (e.g. 128 means 128-bit ### encryption). The values below are the defaults. # min-encryption = 0 # max-encryption = 256
Теперь пора проверить созданный нами svn-сервер, но сначала мы должны перезапустить его чтобы он смог считать изменённые конфигурационные файлы. Для этого набираем “Windows+R” – “cmd.exe“. В открывшейся командной строке пишем слелующие команды (по порядку):
net stop CSVNsvnserve net start CSVNsvnserve
Открываем TortoiseSVN Repository Browser из контекстного меню любой папки и в качестве URL вводим: svn://127.0.0.1/. Сервер запросит указать логин и пароль, заданные в файле passwd и при успешной авторизации отобразит корневой каталог. Сервер успешно настроен и готов к управлению проектами.
Если Вы хотите, чтобы к Вашему репозитарию был доступ не только с помощью svn-клиентов, но и с помощью любого веб-браузера, то должны сделать ряд настроек.
Откройте в любом текстовом редакторе файл “%PROGRAMFILES%\CollabNet\Subversion Server\httpd\conf\httpd.conf“, где “%PROGRAMFILES%\CollabNet\Subversion Server\” – это путь установки svn-серверов. В конце файла httpd.conf найдите следующие строки:
DAV svn SVNParentPath C:\svn_repository
и замените на такие:
DAV svn SVNPath С:\svn_repository AuthType Basic AuthName "Subversion repository" AuthUserFile С:\svn_repository\conf\appswd Require valid-user
Здесь с:\svn_repository – путь к репозиторию svn. Измените в соответствии с Вашими настройками.
Теперь нужно создать файл паролей Apache. Для этого откройте командную строку Windows (“Win+R” – “cmd.exe“) и выполните следующие команды:
cd "%PROGRAMFILES%\CollabNet\Subversion Server\httpd\bin" htpasswd -cmb C:\svn_repository\conf\appswd ЛОГИН_ПОЛЬЗОВАТЕЛЯ_1 ПАРОЛЬ htpasswd -mb C:\svn_repository\conf\appswd ЛОГИН_ПОЛЬЗОВАТЕЛЯ_2 ПАРОЛЬ ... htpasswd -mb C:\svn_repository\conf\appswd ЛОГИН_ПОЛЬЗОВАТЕЛЯ_N ПАРОЛЬ
Внимание! Параметр -cm нужно указывать только при первом создании пользователя, т.к. он перезаписывает имеющийся файл. В пути к файлу паролей буква диска обязательно должна быть в верхнем регистре.
В качестве ЛОГИН_ПОЛЬЗОВАТЕЛЯ нужно указать все логины пользователей, указанные в файле passwd. Пароли также должны быть идентичны.
Настройка SVN over Apache 2 была успешно завершена. Теперь нужно перезапустить сервер командами консоли Windows:
net stop CollabNetSubversionApache net start CollabNetSubversionApache
Протестировать сервер можно так: http://127.0.0.1:ПОРТ/ в любом веб-браузере. Будет запрошен логин и пароль для доступа к репозитарию.
Сегодня прошёл ровно месяц с момента официального релиза первой версии программы TF2 Repair, поэтому мы решили подвести первые итоги её работы за этот месяц.
Итак, за первый месяц было выпущено 5 версий программы (от первой 1.0 до последней на сегодняшний день 1.6). К сожалению, не обошлось без багов, но на сегодняшний день все они успешно исправлены. В новых версиях было добавлено множество функций, исправлены ошибки и недоработки первых версий, увеличена скорость и стабильность работы, добавлена поддержка плагинов и локализаций. Если у Вас всё ещё одна из первых версий (до 1.5), то рекомендуем обновить её до новейшей на сегодняшний день – 1.6 на официальной странице программы.
Количество обращений в неофициальные техподдержки форумов, для которых писалась программа, снизилось в 4 раза (если раньше в общей сложности было около 20-25 вопросов в день, то теперь – 5-6). Количество вопросов по проблемам, которые успешно решаются программой TF2 Repair и вовсе сократилось в 8 раз.
Таким образом, мы можем сделать вывод, что программа полностью оправдала своё предназначение и, грубо говоря, была написана не зря.
Сегодня, 14 марта 2010 года, была выпущена новая версия программы для настройки и восстановления TF2 – TF2 Repair 1.6 Final. В новой версии было сделано несколько изменений: добавлен новый значок и логотип, а также исправлены баги и оптимизирован код.
Полный список изменений версии 1.6 Final:
Скачать программу можно на её официальной странице. Ссылка на скачивание всегда позволяет скачать самую последнюю версию программы.
Сообщения об ошибках этой версии просьба оставлять в комментариях либо к этому сообщению, либо на официальной странице. Мы стараемся исправить как можно быстрее все найденные в программе баги.
Сегодня, 08 марта 2010 года, была выпущена новая версия программы для настройки и восстановления TF2 – TF2 Repair 1.5 Final. В новой версии было сделано множество изменений и исправлены баги. Список изменений версии 1.5 Final:
Скачать программу можно на её официальной странице. Ссылка на скачивание всегда позволяет скачать самую последнюю версию программы.
Сообщения об ошибках этой версии просьба оставлять в комментариях либо к этому сообщению, либо на официальной странице. Мы стараемся исправить как можно быстрее все найденные в программе баги.
В данном HOWTO будет подробно рассказано как работать с самым популярным SVN-клиентом под Windows: скачивать и обновлять репозитарии, создавать теги и ветки проекта, коммитить (публиковать) свою рабочую копию, откатывать сделанные изменения и многое другое.
Скачать программу можно на её официальном сайте на странице Downloads: http://tortoisesvn.net/downloads. Там же можно скачать пакет локализации, содержащий помимо перевода интерфейса программы, ещё и словарь проверки орфографии (применяется при коммите изменений (см. ниже)).
Программа TortoiseSVN интегрируется в Проводник Windows (Windows Explorer) и все действия с ней выполняются из контекстного меню каталогов (папок).
Начнём с самого простого – скачивания одного из репозитариев на свой компьютер.
Если Вы хотите скачать репозитарий какого-нибудь проекта, то Вы должны знать его URL, а также логин и пароль для доступа (если не указаны, то для анонимного доступа (только чтение) используется логин и пароль anonsvn). URL’ы могут быть:
Допустим, что URL нам известен, поэтому чтобы скачать репозитарий, мы должны сделать следующее:
SVN и создавался для удобного управления проектам, а также поддержания их в актуальном состоянии, поэтому вторая по значимости операция – обновления скачанной рабочей копии. Рекомендуется как можно чаще обновлять свои рабочие копии. При обновлении скачиваются только изменённые файлы, добавляются новые и удаляются удалённые из репозитария файлы. Итак, чтобы обновить рабочую копию, нужно:
Если Вы хотите внести свои изменения в скачанный репозитарий и у Вас есть на это право (право коммита в репозитарий), то просто начинайте работать с локальной рабочей копией как с обычной папкой: создавайте, редактируйте, удаляйте файлы и/или папки. Теперь чтобы внести изменения в репозитарий, нужно:
Иногда требуется работать с svn-репозитарием напрямую на сервере не скачивая его на локальный компьютер. Для этих целей существует утилита “SVN Repo-browser“, также входящая в состав TortoiseSVN. Работать с ней очень просто:
Если Вы работаете над большим проектом, то желательно для каждой публичной стабильной версии (1.0, 1.1, 2.0 и т.д.) создавать отдельный тег, например, /tags/RELEASE-Mj.Mn, где Mj – Major-версия, а Mn – Minor-версия проекта. Пример: /tags/RELEASE-1.0 (для версии 1.0), /tags/RELEASE-2.63 (для версии 2.63) и т.д. Внимание! Теги создаются НЕ в каталоге /trunk/, а выше него на один уровень! Чтобы создать метку или ветвление, нужно (у Вас должно быть право коммита в репозитарий для создания меток или ветвлений):
Если работая с локальным репозитарием Вы совершили какую-либо ошибку, например, повредили какой-то файл, неправильно отредактировали и т.д., то это легко исправить:
Утилита Log Viewer, запускаемая после нажатия на кнопку “Show log…“, либо при нажатии правой кнопкой по свободному месту в локальной рабочей копии – “TortoiseSVN” – “Show log“. По умолчанию утилита показывает последние 50 ревизий и их описаний (если во время коммита они были введены). Все основные действия выполняются из контекстного меню ревизии:
Кнопка “Show all” покажет все ревизии, а “Show range…” позволит задать диапазон ревизий, которые будут отображаться в окне Log Viewer.
Кнопка “Statistics” отображает различную статистическую информацию: наиболее активный и наименее активный автор, количество изменений в репозитарии в неделю, общее количество изменений и т.д.
Сегодня, 23 февраля 2010 года, была выпущена новая версия программы для настройки и восстановления TF2 – TF2 Repair 1.1 Final. В новой версии было исправлено несколько багов, а также добавлены новые функции.
Список изменений:
Скачать программу можно на её официальной странице. Ссылка на скачивание всегда позволяет скачать самую последнюю версию программы.
Сообщения об ошибках этой версии просьба оставлять в комментариях либо к этому сообщению, либо на официальной странице. Мы стараемся исправить как можно быстрее все найденные в программе баги.
Последние комментарии