robusta

робуста

Просто простой веб-сайт для обмена технологическими знаниями. Живая демо-версия доступна по адресу: https://goway.herokuapp.com.

Этот проект соответствует стандартам golang/project-layout и, следовательно, может использоваться в качестве справочника для новых разработчиков Go.

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

Предварительные условия

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

• Бэкэнд:

  • Перейти SDK: 1.13. Убедитесь, что $GOROOT и $GOPATH установлены правильно. Вы можете проверить эту переменную среды, набрав: go env .
  • MongoDB: 4.1 (последняя версия 4.1.8).
  • Модуль Go

• Внешний интерфейс:

  • NodeJS: 11.10 (последняя версия 11.10.0).
  • Используйте yarn вместо npm .
  • Фреймворк: VueJS 2.x (последняя версия 2.6.6).
  • Структура компонентов пользовательского интерфейса: Element-UI (последняя версия 2.5.4).

• Общее:

  • ОС: Если возможно, следует использовать Linux (последнюю версию Ubuntu или дистрибутив по вашему выбору). Windows не очень хорошо работает с Docker и некоторыми другими технологиями, которые мы можем использовать. Если вы по-прежнему предпочитаете использовать Windows, вам, возможно, придется решать проблемы самостоятельно позже, поскольку мы предполагаем, что все будет разрабатываться и работать на Linux.
  • Установите Docker CE (последнюю версию 18.x) и docker-compose.
  • Установите git для управления исходным кодом.
  • IDE на ваш выбор, рекомендуемая Goland или VS Code .

Разработка

1. Клонировать код на локальный

$ go get -u -v github.com/pthethanh/robusta
or
$ cd $GOPATH /src
$ git clone https://github.com/pthethanh/robusta.git

После этого шага исходный код должен быть доступен по адресу $GOPATH/src/github.com/pthethanh/robusta .

2. Запустите среду разработки с помощью Docker.

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

$ cd /web && yarn install && cd ../
$ make compose_dev

После запуска службы будут доступны на localhost с портами, указанными ниже:

 MongoDB: 27017
Backend: 8080
Frontend: 8081

Тестирование аутентификации Google локально

Google не поддерживает OAuth с локальным хостом или любым доменом с портом, но наш сервер работает на 8080, поэтому нам нужно создать локальный домен с именем mylocalhost.com и убедиться, что все запросы к этому домену перенаправляются на работающий сервер. в порту 8080

Необходимо выполнить следующие шаги :

1. Обновите iptables

sudo iptables -t nat -I OUTPUT -p tcp -d 127.0.0.1 --dport 80 -j REDIRECT --to-ports 8080

2. Обновите /etc/hosts.

127.0.0.1 mylocalhost.com

3. Обновите конфигурации Google OAuth2.

Убедитесь, что mylocalhost.com обновлен в консоли Google. Добавьте http://mylocalhost.com/auth/google/callback в Authorized redirect URIs API консоли Google.

Проверка веб-производительности с использованием ограничения размера

 make size

Более подробную информацию см. в разделе «Ограничение размера» на github.

Полезные плагины VS Code

• Ветур (octref.vetur)
• Перейти (ms-vscode.go)
• формат vue (febean.vue-формат)
• Проверка орфографии кода (streetsidesoftware.code-spell-checker)
• GitLens — улучшенный Git (eamodio.gitlens)
• Докер (ms-azuretools.vscode-docker)

Примечания

• Обязательно запустите go fmt , go vet , go test и go build / go install прежде чем отправлять свой код на Github. Или вы можете просто запустить make перед отправкой.
• Никогда не принимайте непосредственное участие в master или develop веток (в любом случае у вас нет на это разрешения). Вместо этого, оформляйте заказ из ветки develop в отдельную ветку, а затем работайте над этим.
  Всякий раз, когда вы заканчиваете свою работу, вы можете создать запрос на включение (PR)/запрос на слияние (MR), чтобы запросить проверку кода и объединить вашу ветку обратно для develop .
  ветка master будет зарезервирована, когда администратор решит выпустить стабильную версию приложения.
• Вся документация должна быть написана в формате Markdown, в качестве редактора Markdown рекомендуется использовать Typora.

Технические требования:

Цвет: https://www.colourlovers.com/palette/173625/Browser_wars

TODO

Требуется обновление