SpeedUpAmerica
1.0.0
Speedupamerica предоставляет на землю правду о Интернете в Америке. Наши национальные и локализованные широкополосные карты обеспечивают прозрачность: полученные скорости в Интернете, фактические цены и уровень обслуживания. Эта информация помогает направлять государственные и частные инвестиции в интернет -инфраструктуру в местах, которые нуждаются в ней больше всего. Мы также рассматриваем этот подход как лучшее решение для национального широкополосного картирования, чем то, которое в настоящее время используется в настоящее время FCC.
Если вы разработчик программного обеспечения, мы бы хотели вашу помощь, и мы можем заплатить вам за ваше время!
Легко размышлять о том, какие области сообщества имеют медленный доступ в Интернет, но без данных практически невозможно узнать, кто получает хорошее, надежное обслуживание и где существуют возможности для улучшения. Точная информация о наличии интернет -поставщиков, фактических ценных цен и полученных скоростей очень трудно найти. Не хватает реальных данных и информации о недостаточно обслуживаемых областях. Именно здесь нужна общины в Орегоне и по всей стране.
В партнерстве с нами Ignite эти усилия предназначены для продвижения технологии, которая первоначально была построена в Луисвилле Кентукки, которая помогла усилиям города по цифровому включению этого города, и сделать ее доступным для всех городов и сельских сообществ по всей Америке.
Предназначенное решение сочетает в себе результаты тестирования скорости в Интернете с картой всего Соединенных Штатов, которая отфильтрована по штату, почтовому индексу, переписному тракту, блоке Cencus и другими статистическими границами.
В конце концов, мы считаем, что этот инструмент даст нам самые точные данные о том, что на самом деле происходит с точки зрения подключения к Интернету по всей Америке. И это может служить отправной точкой для разговоров между соседями, выборными должностными лицами и интернет -поставщиками.
Цель этого проекта состоит в том, чтобы повысить осведомленность о несправедливости по скорости и качеству Интернета, предоставленного всем в США. Если у вас есть вопросы о чем -либо, присоединяйтесь к разговору.
Добро пожаловать!
Текущая реализация Speedupamerica масштабировалась, чтобы покрыть штат Орегон в июне 2019 года. Вашингтон и Айдахо были добавлены в июле 2019 года. Границы штата и округа добавляются где -то в августе 2019 года.
Проект может быть использован как часть стратегии цифрового включения, чтобы узнать, где находится неравенство в вашем сообществе. Speedupamerica может помочь гражданам, предприятиям, политикам и другим лучше понять, где американцы могут получить доступ к высококачественной интернет-сервисе и где есть потребности, позволяя городам отслеживать и улучшать производительность благодаря ключевым политикам, соглашениям по интернет-проспектам и партнерству.
Все текущие карты цифровых включения полагаются на данные FCC 477, которые представляют собой самооценку ISP, общеизвестно неполный, вводящий в заблуждение, игровые провайдеры и недостаточно детализированы. Давайте поправимся, более точные данные о скорости краудпинга непосредственно от граждан, чтобы принимать лучшие решения и управлять политикой.
В марте 2019 года Луисвилл работал с техническим сообществом в Юджине, штате Орегон и взлома, чтобы разработать кодовую базу, которая может быть единственной единой национальной картой.
Это новое приложение, Speedupamerica.com, собирает и публично делится информацией о масштабах о скоростях местного широкополосного обслуживания, оплаченных ценах и качеством обслуживания по всей Америке. Он также включает в себя тестовые тесты и лабораторные тесты измерения (которые интегрируются с Google.com) и значительно увеличивает количество тестов, которые собирает приложение.
В апреле 2016 года государственная команда OPI2 в Луисвилле Metro, Powerup Labs и другие партнеры запустили веб-приложение, направленное на повышение прозрачности в отношении качества интернет-сервиса в Луисвилле в хакатоне. Луисвилл работал партнерами для открытого исходного коэффициента «ускорения», чтобы любое местное правительство или организация могли запустить это заявление на свое сообщество.
Проект Speeduplouisville.com Oreginally начался в местном гражданском хакатоне во главе с Civic Data Alliance и размещенным Code Louisville и Code for America. Эрик Литтлтон, Джон Матар и команда разработчиков программного обеспечения Powerup Labs позже вызвались продолжить работу, начавшуюся работу во время хакатона. LVL1, местный Makerspace, также предоставил финансирование платных веб -инструментов, необходимых для завершения проекта.
Данные отображаются на интерактивной карте и доступны для бесплатной загрузки, с целью повышения прозрачности качества интернет -услуг в Америке и продолжить разговор о доступе к Интернету в вашем сообществе. Граждане могут посетить сайт с любого устройства, чтобы пройти бесплатный интернет-тест на обслуживание, и дополняется тестами Google M-LAB. Данные, предоставленные тестовым и коротким опросом, хранятся в общедоступной базе данных, в сочетании с другими результатами и опубликованы в онлайн -карте в форме, которая не идентифицирует участников, и позволяет прямой загрузку данных.
Этот тест не собирает информацию о личном интернет -трафике, такой как электронные письма, веб -поиск или другую личную информацию.
Проект Speedupamerica использует следующие технологии для работы:
Эти инструкции работают на Linux, Windows и MacOS и должны выполняться только один раз, если вы не сбросите свою базу данных или файлы конфигурации.
Установите Git Windows/Mac/Linux
Установите Docker и Docker Compose (Docker Compose уже включен в установку Mac и Windows Docker, но не Linux. Пожалуйста, также отметьте установку Win Home отличается от Pro).
Требуется минимум 6 ГБ локального распределения памяти. После запуска Docker зайдите в настройки и настройте объем памяти, которую он может использовать.
Память - Docker Desktop для Mac
Память - Docker Desktop для Windows
В зависимости от вашей ОС, возможно, вам придется использовать
copyвместоcp.
$ git clone https://github.com/Hack4Eugene/SpeedUpAmerica.git
$ git clone https://github.com/Hack4Eugene/speedupamerica-migrator.git
$ cd SpeedUpAmerica
$ cp local.env.template local.env
$ docker-compose up -d mysql
$ docker-compose up --build migrator
$ docker-compose run migrator rake db:seed
$ docker-compose run frontend rake secret Найдите свой local.env . Используйте длинную буквмерную строку вывода из rake secret в качестве значения для SECRET_KEY_BASE . Перейдите в Mapbox и создайте бесплатную учетную запись, чтобы получить токен API Mapbox API. Используйте и установите токен пулика по умолчанию в качестве вашего MAPBOX_API_KEY в файле local.env .
Эти инструкции предполагают, что пользователи Windows не используют WSL, который имеет документированные проблемы с Docker's Bind Mounts. Установка и настройка Docker для Windows для работы с WSL выходит за рамки этого документа.
Загрузите один из двух файлов SQL и поместите его в каталог data проектов:
Вкладчики: если вы обновляете любой из этих файлов, обязательно измените имя файла и обновите все ссылки в этом документе.
Замените имя файла и запустите эту линию:
$ docker-compose exec -T mysql mysql -u suyc -psuyc suyc < data/ < SQL filename > $ docker-compose up -d Доступ к сайту можно получить по адресу http://localhost:3000/ . Приложение Ruby настроено, чтобы не кэш, и не требует перезапуска контейнера Docker для загрузки изменений, если это не изменение конфигурации. Просто сделайте свои изменения и перезагрузите страницу. Загрузка первой страницы сделайте немного. Смотрите docker-compose logs frontend для Stdout/Stderr.
docker-compose.yml включает в себя контейнер в концентраторе Jupyter на основе jupyter/datascience-notebook . Он включает в себя несколько модулей с добавлением Python для работы с MySQL и Mapbox. После настройки базы данных и загрузки набора данных, вы можете запустить Hupyter Hub, запустив docker-compose up notebooks . После готовности он выведет URL и токен, которые вам нужно будет использовать для доступа к центру Jyter в вашем браузере. Записные книжки и другие файлы сохраняются в ./notebooks
$ docker-compose stopЕсли сайт не загружается правильно на Localhost после получения новых изменений из GIT и перезапуска Docker, попробуйте следующее:
# Show the docker tasks and their exit statuses
$ docker-compose ps
# You might also be interested in seeing the logs for a failing process
# Choose the option below for the process you're interested in:
$ docker-compose logs frontend
$ docker-compose logs migrator
$ docker-compose logs mysql Если docker-compose ps показывает «выход 1» для любого процесса, то, вероятно, причина заключается в том, что изображение Docker процесса необходимо восстановить. Как правило, это связано с изменением зависимостей с тех пор, как вы в последний раз строили изображение. Дополнительный намек на то, что это причина, если в журналах показывают ошибки, указывающие на то, что зависимость не может быть найдена.
Чтобы решить это, восстановите изображение Docker для этого конкретного процесса. Например, если процесс frontend выходит со статусом ошибки:
$ docker-compose up --build frontend Если docker-compose ps продолжает бросать ошибку «Выход 1» для любого процесса после восстановления фронта, убедитесь, что ваши разрешения брандмауэра ваших машин разрешают приложения. После того, как вы установите разрешения брандмауэра, вам нужно будет закрыть свой рабочий процесс, перезапустить Docker и перезапустить приложение.
Если после того, как вы включите протси по брандмауэру, у вас все еще есть проблемы с «выходом 1», вам может потребоваться удалить TMP/PIDS/Server.PID, а затем docker-compose up -d
Установка на Ubuntu.
Запуск среды локально в ОС на основе Linux может потребовать выполнения команд docker-compose как Super User, sudo docker-compose [commands] .
Вот руководство по управлению Docker в качестве пользователя, не являющегося корнями.
Предполагается, что у вас есть недавний файл
.sql, загруженный из инструкций по настройке.
Когда границы обновляются, каждый разработчик должен перезагрузить свои границы. Поскольку новые границы также могут потребовать добавления столбцов в таблицу материалов, лучше всего полностью перезагрузить базу данных.
$ docker-compose stop mysql
$ docker-compose rm mysql
$ docker-compose up mysql
$ docker-compose up --build migrator
$ docker-compose exec -T mysql mysql -u suyc -psuyc suyc < data/sua_20190803.sqlПри обновлении файлов SQL обязательно удалите предупреждение из первой строки файла.
Обязательно замените <date> на сегодняшнюю дату в кратком формате (например, 20190801 ).
$ docker-compose exec mysql mysqldump --no-create-info -u suyc -psuyc suyc --ignore-table=suyc.schema_migrations --hex-blob > data/sua_ < date > .sqlСледуйте следующим трем разделам, чтобы загрузить последние данные, очистить таблицу границ и загрузить данные. Вы должны следовать этим указаниям только при удалении вашего БД, а загрузка самого последнего дампа SQL не является вариантом.
Предполагается, что у вас есть эти файлы в data/ :
Для Linux и MacOS, пожалуйста, используйте следующее:
$ docker-compose exec -T mysql mysql -u suyc -psuyc suyc <<< " TRUNCATE boundaries; "Для ОС Windows, пожалуйста, используйте следующее:
$ docker-compose exec mysql mysql -u suyc -psuyc suyc
$ mysql> TRUNCATE boundaries;
$ mysql> exit
$ docker-compose run frontend rake populate_boundaries
Каждую ночь в тестовых и производственных средах запускается процесс импорта данных, который импортирует недавние данные M-LAB, обновляют границы, пересаживаются кэши и другие задачи, связанные с данными.
Некоторые этапы ночного процесса импорта требуют ключа сервисного обслуживания BigQuery с доступом к данным измерения лаборатории.
Ночной процесс начинается с запуска ./update_data.sh . На вашем местном окружении вы можете:
$ docker-compose run frontend ./update_data.shТребуется ключ сервисного обслуживания BigQuery с доступом к данным измерительной лаборатории.
$ docker-compose run frontend rake import_mlab_submissions$ docker-compose run frontend rake populate_missing_boundaries$ docker-compose run frontend rake update_providers_statistics $ docker-compose run frontend rake update_stats_cache
См. Appling.md.
Комитеты:
Технический комитет:
