Конфигурация

После установки данного программного обеспечения вам может потребоваться выполнить некоторые из этих шагов по настройке, в зависимости от ваших задач.

Заполнение базы данных

Ваша установка не содержит загруженных географических данных. Вы можете создать новые данные с помощью одного из редакторов (Potlatch 2, iD, JOSM и т. д.) или загрузить экстракт OSM.

После установки, но перед созданием пользователей или данных, импортируйте экстракт с помощью Osmosis и задачи --write-apidb.

osmosis --read-pbf greater-london-latest.osm.pbf \
  --write-apidb host="localhost" database="openstreetmap" \
  user="openstreetmap" password="" validateSchemaVersion="no"

Загрузка базы данных apidb с Osmosis примерно в двадцать раз медленнее, чем загрузка эквивалентных данных с osm2pgsql в базу данных рендеринга. --log-progress может быть желателен для обновления статуса.

Чтобы иметь возможность редактировать загруженные данные, вам потребуется использовать этот ещё не написанный скрипт.

Управление пользователями

Если вы создадите пользователя, зарегистрировавшись на своём локальном веб-сайте, вам необходимо подтвердить пользователя, прежде чем вы сможете войти в систему, что обычно происходит при нажатии на ссылку, отправленную по электронной почте. Если вы не хотите настраивать свой рабочий компьютер для отправки электронных писем на общедоступные адреса электронной почты, вы можете создать пользователя как обычно, а затем подтвердить его вручную через консоль Rails:

$ bundle exec rails console
>> user = User.find_by_display_name("My New User Name")
=> #[ ... ]
>> user.status = "active"
=> "active"
>> user.save!
=> true
>> quit

Предоставление прав администратора/модератора

Для предоставления прав администратора или модератора:

$ bundle exec rails console
>> user = User.find_by_display_name("My New User Name")
=> #[ ... ]
>> user.roles.create(:role => "administrator", :granter_id => user.id)
=> #[ ... ]
>> user.roles.create(:role => "moderator", :granter_id => user.id)
=> #[ ... ]
>> user.save!
=> true
>> quit

Ключи потребителя OAuth

Три встроенных приложения обмениваются данными через API, поэтому им требуется настроить ключи потребителя OAuth. Это:

• Potlatch 2
• iD
• Сам веб-сайт (для функциональности Notes)

Например, чтобы использовать редактор Potlatch 2, вам нужно зарегистрировать его как приложение OAuth.

Выполните следующие действия:

• Войдите в свой экземпляр Rails Port — например, http://localhost:3000
• Нажмите на своё имя пользователя, чтобы перейти на страницу пользователя
• На странице пользователя нажмите «Мои настройки»
• На странице Мои настройки нажмите «Настройки OAuth»
• Нажмите «Зарегистрировать ваше приложение».
• Если вы не настроили альтернативы, используйте Имя: «Local Potlatch» и URL: «http://localhost:3000»
• Установите флажок «Изменить карту».
• Всё остальное можно оставить со значениями по умолчанию.
• Нажмите кнопку «Регистрация».
• На следующей странице скопируйте «ключ потребителя».
• Отредактируйте config/application.yml в вашем дереве rails
• Раскомментируйте и измените значение конфигурации «potlatch2_key»
• Перезапустите ваш сервер rails

Пример выдержки из application.yml:

# Default editor
default_editor: "potlatch2"
# Ключ потребителя OAuth для Potlatch 2
potlach2_key: "8lFmZPsagHV4l3rkAHq0hWY5vV3Ctl3oEFY1aXth"

Проделайте тот же процесс для регистрации и настройки iD (id_key) и веб-сайта/Notes (oauth_key), или, чтобы сэкономить время, просто повторно используйте один и тот же ключ потребителя для каждого.

Устранение неполадок

У Rails есть собственный журнал. Чтобы проверить журнал, сделайте следующее:

tail -f log/development.log

Если у вас возникнут дополнительные проблемы, пожалуйста, обратитесь к списку рассылки rails-dev@openstreetmap.org или в IRC-канал #osm-dev

Обслуживание вашей установки

Если ваша установка по какой-то причине перестаёт работать:

• Иногда меняются зависимости гемов. Чтобы обновить, перейдите в каталог rails_port и запустите «bundle install» от имени root.

• Изменяется схема базы данных OSM Периодически необходимо следить за этими улучшениями. Перейдите в каталог rails_port и выполните:

bundle exec rake db:migrate

Тестирование на сервере osm dev

Например, после разработки патча для rails_port вы можете захотеть продемонстрировать его другим или попросить комментарии и тестирование. Для этого можно настроить экземпляр rails_port на сервере разработки в пользовательском каталоге.

Вклад

Информацию о внесении изменений в код см. в CONTRIBUTING.md.

Развёртывание в рабочей среде

Если вы хотите развернуть Rails Port для использования в рабочей среде, вам потребуется внести несколько изменений.

• Не рекомендуется использовать rails server в рабочей среде. Мы рекомендуем использовать Phusion Passenger. Инструкции доступны для настройки с большинством веб-серверов.
• Пассажир по своей конструкции будет использовать рабочую среду и, следовательно, рабочую базу данных — убедитесь, что она содержит соответствующие данные и учётные записи пользователей.
• Вашей производственной базе данных также потребуются установленные расширения и функции — см. INSTALL.md.
• Включённая версия вызова карты работает довольно медленно и занимает много памяти. Вам следует рассмотреть возможность использования CGIMap вместо неё.
• Включённая версия импортёра GPX работает медленно и/или полностью не работает. Вам следует рассмотреть возможность использования высокоскоростного импортёра GPX.
• Убедитесь, что вы предварительно скомпилировали производственные ресурсы: RAILS_ENV=production rake assets:precompile.
• Убедитесь, что пользователь веб-сервера, а также пользователь rails могут читать, записывать и создавать каталоги в tmp/ .