Czym jest Heroku#

Heroku to popularne, kompleksowe rozwiązanie hostingowe, więcej informacji znajdziesz na heroku.com

Rejestracja#

Będziesz potrzebować konta heroku, jeśli go nie masz, zarejestruj się tutaj: https://signup.heroku.com/

Instalacja CLI#

Upewnij się, że zainstalowałeś narzędzie heroku cli.

HomeBrew#

brew tap heroku/brew && brew install heroku

Inne opcje instalacji#

Zobacz alternatywne opcje instalacji tutaj: https://devcenter.heroku.com/articles/heroku-cli#download-and-install.

Logowanie#

Po zainstalowaniu cli, zaloguj się za pomocą:

heroku login

Zweryfikuj, że zalogowany jest właściwy adres e-mail za pomocą:

heroku auth:whoami

Utwórz aplikację#

Odwiedź dashboard.heroku.com, aby uzyskać dostęp do swojego konta, i utwórz nową aplikację z rozwijanego menu w prawym górnym rogu. Heroku zada kilka pytań, takich jak region i nazwa aplikacji, po prostu postępuj zgodnie z instrukcjami.

Git#

Heroku używa Gita do wdrażania Twojej aplikacji, więc musisz umieścić swój projekt w repozytorium Git, jeśli jeszcze tego nie zrobiłeś.

Zainicjuj Git#

Jeśli musisz dodać Git do swojego projektu, wpisz następującą komendę w terminalu:

git init

Main#

Powinieneś zdecydować się na jedną gałąź i trzymać się jej przy wdrażaniu na Heroku, taką jak gałąź main lub master. Upewnij się, że wszystkie zmiany są zatwierdzone (committed) w tej gałęzi przed pushowaniem.

Sprawdź swoją bieżącą gałąź za pomocą:

git branch

Gwiazdka wskazuje bieżącą gałąź.

* main
  commander
  other-branches

Jeśli aktualnie nie jesteś na właściwej gałęzi, przełącz się na nią, wpisując (dla main):

git checkout main

Zatwierdź zmiany#

Jeśli ta komenda zwraca jakiś wynik, oznacza to, że masz niezatwierdzone zmiany.

git status --porcelain

Zatwierdź je za pomocą poniższego

git add .
git commit -m "a description of the changes I made"

Połącz z Heroku#

Połącz swoją aplikację z heroku (zamień na nazwę swojej aplikacji).

$ heroku git:remote -a your-apps-name-here

Ustaw buildpack#

Ustaw buildpack, aby nauczyć heroku, jak radzić sobie z vapor.

heroku buildpacks:set vapor/vapor

Plik wersji Swift#

Dodany buildpack szuka pliku .swift-version, aby wiedzieć, której wersji swift użyć. (Zamień 5.8.1 na wersję, jakiej wymaga Twój projekt.)

echo "5.8.1" > .swift-version

To tworzy .swift-version z 5.8.1 jako jego zawartością.

Procfile#

Heroku używa Procfile, aby wiedzieć, jak uruchomić Twoją aplikację, w naszym przypadku musi to wyglądać tak:

web: App serve --env production --hostname 0.0.0.0 --port $PORT

Możemy to utworzyć za pomocą następującej komendy terminala

echo "web: App serve --env production" \
  "--hostname 0.0.0.0 --port \$PORT" > Procfile

Zatwierdź zmiany#

Właśnie dodaliśmy te pliki, ale nie są one zatwierdzone. Jeśli je wypushujemy, heroku ich nie znajdzie.

Zatwierdź je za pomocą poniższego.

git add .
git commit -m "adding heroku build files"

Wdrażanie na Heroku#

Jesteś gotowy do wdrożenia, uruchom to z terminala. Zbudowanie może potrwać chwilę, to normalne.

git push heroku main

Skalowanie w górę#

Po pomyślnym zbudowaniu musisz dodać przynajmniej jeden serwer. Ceny zaczynają się od 5 USD/miesiąc za plan Eco (zobacz cennik), upewnij się, że masz skonfigurowaną płatność na Heroku. Następnie dla pojedynczego web workera:

heroku ps:scale web=1

Kontynuacja wdrażania#

Za każdym razem, gdy chcesz zaktualizować aplikację, wystarczy pobrać najnowsze zmiany do main i wypushować na heroku, a nastąpi ponowne wdrożenie.

Postgres#

Dodaj bazę danych PostgreSQL#

Odwiedź swoją aplikację na dashboard.heroku.com i przejdź do sekcji Add-ons.

Tutaj wpisz postgres, a zobaczysz opcję Heroku Postgres. Wybierz ją.

Wybierz plan Essential 0 za 5 USD/miesiąc (zobacz cennik) i zainicjuj (provision). Heroku zajmie się resztą.

Po zakończeniu zobaczysz bazę danych w zakładce Resources.

Skonfiguruj bazę danych#

Musimy teraz powiedzieć naszej aplikacji, jak uzyskać dostęp do bazy danych. W katalogu naszej aplikacji uruchommy.

heroku config

To wygeneruje wynik podobny do tego

=== today-i-learned-vapor Config Vars
DATABASE_URL: postgres://cybntsgadydqzm:2d9dc7f6d964f4750da1518ad71hag2ba729cd4527d4a18c70e024b11cfa8f4b@ec2-54-221-192-231.compute-1.amazonaws.com:5432/dfr89mvoo550b4

DATABASE_URL reprezentuje tutaj naszą bazę danych postgres. NIGDY nie zapisuj na stałe (hard code) statycznego adresu url z tego, heroku będzie go rotować, co spowoduje awarię Twojej aplikacji. To również zła praktyka. Zamiast tego odczytuj zmienną środowiskową w czasie działania (runtime).

Dodatek Heroku Postgres wymaga, aby wszystkie połączenia były szyfrowane. Certyfikaty używane przez serwery Postgres są wewnętrzne dla Heroku, dlatego konieczne jest skonfigurowanie niezweryfikowanego (unverified) połączenia TLS.

Poniższy fragment kodu pokazuje, jak osiągnąć jedno i drugie:

if let databaseURL = Environment.get("DATABASE_URL") {
    var tlsConfig: TLSConfiguration = .makeClientConfiguration()
    tlsConfig.certificateVerification = .none
    let nioSSLContext = try NIOSSLContext(configuration: tlsConfig)

    var postgresConfig = try SQLPostgresConfiguration(url: databaseURL)
    postgresConfig.coreConfiguration.tls = .require(nioSSLContext)

    app.databases.use(.postgres(configuration: postgresConfig), as: .psql)
} else {
    // ...
}

Nie zapomnij zatwierdzić tych zmian

git add .
git commit -m "configured heroku database"

Cofanie zmian w bazie danych#

Możesz cofnąć zmiany lub uruchomić inne komendy na heroku za pomocą komendy run.

Aby cofnąć zmiany w bazie danych:

heroku run App -- migrate --revert --all --yes --env production

Aby zmigrować:

heroku run App -- migrate --env production