Ruby: Pierwsze kroki

Pierwsze kroki z Ruby on Rails

👋 Witamy w dokumentacji Stackhero!

Stackhero oferuje gotowe do użycia rozwiązanie Ruby cloud, które zapewnia wiele korzyści, w tym:

Wdrażaj swoją aplikację w kilka sekund za pomocą prostego git push.

Używaj własnej nazwy domeny i korzystaj z automatycznej konfiguracji certyfikatów HTTPS dla zwiększonego bezpieczeństwa.

Ciesz się spokojem dzięki automatycznym kopiom zapasowym, aktualizacjom jednym kliknięciem oraz prostemu, przejrzystemu i przewidywalnemu cennikowi.

Uzyskaj optymalną wydajność i solidne zabezpieczenia dzięki prywatnej i dedykowanej VM.

Oszczędzaj czas i upraszczaj sobie życie: wypróbowanie rozwiązania Ruby cloud hosting Stackhero zajmuje tylko 5 minut!

Witamy w przewodniku wprowadzającym do Ruby on Rails. W tym przewodniku zostaniesz zapoznany z jednym z najpopularniejszych frameworków aplikacji webowych, zaprojektowanym w celu uproszczenia i przyspieszenia procesu tworzenia aplikacji.

Ruby on Rails (często nazywany po prostu Rails) to framework aplikacji webowych po stronie serwera zbudowany w języku Ruby. Stosuje wzorzec architektoniczny model-view-controller (MVC) i opiera się na zasadach Convention over Configuration (CoC) oraz Don't Repeat Yourself (DRY). Te cechy sprawiają, że Rails jest potężną, wydajną i elastyczną opcją dla tworzenia aplikacji webowych.

Poniżej przeprowadzimy Cię przez kluczowe kroki uruchomienia nowego projektu Ruby on Rails. Nauczysz się, jak zainstalować Ruby i Rails, skonfigurować swój pierwszy projekt, a nawet stworzyć prostą aplikację "Hello World". Dodatkowe wskazówki są dostępne dla różnych środowisk deweloperskich, w tym korzystania z platformy online Stackhero Code-Hero.

Zrozumienie różnicy między Ruby a Rails

Ruby to dynamiczny, open-source'owy język programowania podobny do PHP, JavaScript czy Python. Kładzie nacisk na prostotę i produktywność z elegancką składnią, która jest łatwa do czytania i pisania.

Rails to solidny framework aplikacji webowych po stronie serwera, który działa na Ruby. Oferuje ustrukturyzowane, standardowe podejście do budowania aplikacji webowych, dostarczając narzędzia i biblioteki upraszczające typowe zadania deweloperskie.

Wielu deweloperów wybiera Ruby on Rails zamiast samego Ruby, ponieważ jego kompleksowy framework usprawnia rozwój i zwiększa produktywność.

Konfiguracja projektu Ruby

Rozpoczęcie nowego projektu Ruby jest proste. Wykonaj te kroki, aby zacząć:

Najpierw upewnij się, że masz zainstalowaną najnowszą wersję Ruby na swoim systemie. Możesz to zweryfikować, wykonując następujące polecenie w terminalu:
```
asdf install ruby latest \
  && asdf global ruby latest
```
Jeśli nie zainstalowałeś jeszcze asdf, będziesz musiał to zrobić przed kontynuowaniem. Proszę zapoznać się z oficjalną dokumentacją asdf w celu uzyskania szczegółowych instrukcji instalacji.

Alternatywnie, możesz użyć Stackhero Code-Hero, rozwiązania do rozwoju online, gdzie wszystkie niezbędne narzędzia są wstępnie zainstalowane. Ta platforma pozwala na natychmiastowe rozpoczęcie kodowania bez ręcznej instalacji.
Następnie zainstaluj Rails. Rails jest dystrybuowany jako RubyGem, co sprawia, że instalacja jest prosta:
```
gem install rails
```
Następnie utwórz nową aplikację Rails o nazwie my_app i określ wersję Ruby za pomocą tych poleceń:
```
rails new my_app
cd my_app
asdf local ruby latest
```
Aby uruchomić serwer Rails, wykonaj następujące polecenie:
```
bin/rails server
```
Ekran powitalny Ruby on Rails

Te kroki tworzą nowy projekt Ruby, jednocześnie ustawiając odpowiednią wersję Ruby. To stanowi solidną podstawę dla rozwoju Twojej aplikacji.

Ważne: Podczas wykonywania polecenia rails new, lokalne repozytorium Git jest automatycznie tworzone dla Twojego projektu Ruby. Jednak nie jest jeszcze połączone z zdalną usługą kontroli wersji.

Dla właściwej kontroli wersji i bezpieczeństwa danych, zaleca się połączenie projektu z usługą hostingową, taką jak GitLab, GitHub lub Bitbucket.

Jeśli potrzebujesz usługi hostingowej repozytorium, Stackhero oferuje usługę chmurową GitLab, którą można skonfigurować w zaledwie 2 minuty.

Specjalny przypadek z Stackhero Code-Hero

Podczas korzystania z rozwiązania do rozwoju online, takiego jak Stackhero Code-Hero, musisz dostosować swój plik config/environments/development.rb. Dodaj następującą konfigurację w pobliżu końcowego słowa kluczowego end. Zamień <XXXXXX>.stackhero-network.com na rzeczywistą nazwę hosta serwera:

config.hosts << "<XXXXXX>.stackhero-network.com"

Przykład konfiguracji hostów

Na koniec uruchom serwer Rails za pomocą tego polecenia:

bin/rails server -b 0.0.0.0

To polecenie zapewnia, że serwer Rails jest dostępny z dowolnego adresu IP, co jest szczególnie przydatne podczas pracy zdalnej za pośrednictwem Stackhero Code-Hero.

Tworzenie pierwszej aplikacji "hello world" z Ruby on Rails

Przejdźmy przez proces tworzenia prostej aplikacji "Hello World" za pomocą Ruby on Rails.

Najpierw skonfiguruj nową trasę dla swojej aplikacji. Otwórz plik config/routes.rb i zdefiniuj trasę główną, która wskazuje na akcję hello#index:
```
Rails.application.routes.draw do
  root "hello#index"
end
```
Następnie wygeneruj kontroler Hello, aby zarządzać logiką dla tej trasy. Wykonaj następujące polecenie w terminalu:
```
bin/rails generate controller Hello index --skip-routes
```
Dzięki tej konfiguracji każde żądanie skierowane do ścieżki URL / będzie obsługiwane przez HelloController.
Aby wyświetlić komunikat "Hello World", utwórz widok. Otwórz plik w app/views/hello/index.html.erb i zastąp istniejącą zawartość następującym kodem:
```
<h1>Hello World!</h1>
```
Na koniec uruchom serwer Rails, wykonując poniższe polecenie w terminalu. Następnie połącz się z adresem URL swojego środowiska deweloperskiego (na przykład http://<XXXXXX>.stackhero-network.com:3000), aby zobaczyć swoją aplikację:
```
bin/rails server -b 0.0.0.0
```
Pierwsza strona "Hello World" w Ruby on Rails

Gratulacje. Właśnie stworzyłeś swoją pierwszą aplikację Ruby on Rails!

Zarządzanie zmiennymi środowiskowymi

Zmienne środowiskowe są niezbędne do ochrony wrażliwych danych, takich jak klucze API i hasła do baz danych.

Gem dotenv-rails oferuje wygodny sposób zarządzania zmiennymi środowiskowymi w środowisku deweloperskim. Oto kroki:

Dodaj gem do swojego Gemfile w odpowiednich grupach:

# Gemfile
gem 'dotenv-rails', groups: [:development, :test]

Zainstaluj gem, wykonując:
```
bundle install
```
Utwórz plik .env w katalogu głównym swojego projektu i zdefiniuj swoje zmienne środowiskowe. Na przykład:
```
RAILS_ENV=development
```
Aby chronić swoje wrażliwe dane, upewnij się, że plik .env jest wykluczony z repozytorium Git. Dodaj następującą linię do swojego .gitignore:
```
echo '.env*' >> .gitignore
```

Po wykonaniu tych kroków, zrestartuj serwer Rails. Zmienne środowiskowe zdefiniowane w pliku .env będą teraz automatycznie dostępne w Twojej aplikacji.

Zmienne środowiskowe dla Twojej platformy deweloperskiej