Ruby: Pradžia

Pradžia su Ruby on Rails

👋 Sveiki atvykę į Stackhero dokumentaciją!

Stackhero siūlo paruoštą naudoti Ruby cloud sprendimą, kuris suteikia daugybę privalumų, įskaitant:

Įdiekite savo programą per kelias sekundes su paprastu git push.

Naudokite savo domeno vardą ir pasinaudokite automatiniu HTTPS sertifikatų konfigūravimu, kad padidintumėte saugumą.

Mėgaukitės ramybe su automatinėmis atsarginėmis kopijomis, vieno paspaudimo atnaujinimais ir paprasta, skaidria bei prognozuojama kainodara.

Gaukite optimalią veikimo ir tvirtą saugumą dėka privačios ir dedikuotos VM.

Taupykite laiką ir supaprastinkite savo gyvenimą: išbandyti Stackhero Ruby cloud hosting sprendimą užtrunka tik 5 minutes!

Sveiki atvykę į Ruby on Rails pradžios vadovą. Šiame vadove susipažinsite su vienu iš populiariausių žiniatinklio programų karkasų, sukurtu siekiant supaprastinti ir pagreitinti jūsų kūrimo procesą.

Ruby on Rails (dažnai tiesiog vadinamas Rails) yra serverio pusės žiniatinklio programų karkasas, sukurtas naudojant Ruby. Jis laikosi modelio-vaizdo-valdiklio (MVC) architektūros modelio ir remiasi Konvencijos prieš konfigūraciją (CoC) ir Nesikartokite (DRY) principais. Šios savybės daro Rails galingu, efektyviu ir lanksčiu pasirinkimu žiniatinklio kūrimui.

Žemiau pateikiame esminius žingsnius, kaip pradėti naują Ruby on Rails projektą. Sužinosite, kaip įdiegti Ruby ir Rails, sukurti pirmąjį projektą ir netgi sukurti paprastą "Hello World" programą. Papildomos gairės pateikiamos skirtingoms kūrimo aplinkoms, įskaitant naudojimąsi internetine platforma Stackhero Code-Hero.

Suprasti skirtumą tarp Ruby ir Rails

Ruby yra dinaminė, atvirojo kodo programavimo kalba, panaši į PHP, JavaScript ar Python. Ji pabrėžia paprastumą ir produktyvumą su elegantiška sintakse, kurią lengva skaityti ir rašyti.

Rails yra tvirtas serverio pusės žiniatinklio programų karkasas, veikiantis su Ruby. Jis suteikia struktūruotą, standartizuotą požiūrį į žiniatinklio programų kūrimą, siūlydamas įrankius ir bibliotekas, kad supaprastintų įprastas kūrimo užduotis.

Daugelis kūrėjų renkasi Ruby on Rails, o ne vien Ruby, nes jo išsamus karkasas supaprastina kūrimą ir padidina produktyvumą.

Ruby projekto nustatymas

Naujo Ruby projekto pradžia yra paprasta. Sekite šiuos žingsnius, kad pradėtumėte:

Pirmiausia įsitikinkite, kad jūsų sistemoje įdiegta naujausia Ruby versija. Tai galite patikrinti vykdydami šią komandą terminale:
```
asdf install ruby latest \
  && asdf global ruby latest
```
Jei dar neįdiegėte asdf, turėsite tai padaryti prieš tęsdami. Prašome kreiptis į oficialią asdf dokumentaciją dėl išsamių diegimo instrukcijų.

Alternatyviai, galite naudoti Stackhero Code-Hero, internetinį kūrimo sprendimą, kuriame visi reikalingi įrankiai yra iš anksto įdiegti. Ši platforma leidžia pradėti koduoti iš karto be rankinio diegimo.
Toliau įdiekite Rails. Rails yra platinamas kaip RubyGem, todėl diegimas yra paprastas:
```
gem install rails
```
Tada sukurkite naują Rails programą, pavadintą my_app, ir nurodykite Ruby versiją naudodami šias komandas:
```
rails new my_app
cd my_app
asdf local ruby latest
```
Norėdami paleisti Rails serverį, vykdykite šią komandą:
```
bin/rails server
```
Ruby on Rails pasveikinimo ekranas

Šie žingsniai sukuria naują Ruby projektą, nustatant tinkamą Ruby versiją. Tai sudaro tvirtą pagrindą jūsų programos kūrimui.

Svarbu: Vykdant rails new komandą, automatiškai sukuriamas vietinis Git saugykla jūsų Ruby projektui. Tačiau jis dar nėra susietas su nuotoline versijų valdymo paslauga.

Norint tinkamai valdyti versijas ir užtikrinti duomenų saugumą, rekomenduojama prijungti savo projektą prie talpinimo paslaugos, tokios kaip GitLab, GitHub ar Bitbucket.

Jei jums reikia saugyklos talpinimo paslaugos, Stackhero siūlo GitLab debesų paslaugą, kurią galima nustatyti vos per 2 minutes.

Specialus atvejis su Stackhero Code-Hero

Naudojant internetinį kūrimo sprendimą, kaip Stackhero Code-Hero, turite koreguoti savo config/environments/development.rb failą. Pridėkite šią konfigūraciją šalia galutinio end raktažodžio. Pakeiskite <XXXXXX>.stackhero-network.com į savo tikrąjį serverio pavadinimą:

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

Pavyzdys, kaip konfigūruoti šeimininkus

Galiausiai, paleiskite Rails serverį su šia komanda:

bin/rails server -b 0.0.0.0

Ši komanda užtikrina, kad Rails serveris būtų pasiekiamas iš bet kurio IP adreso, kas ypač naudinga dirbant nuotoliniu būdu per Stackhero Code-Hero.

Pirmojo "hello world" programos kūrimas su Ruby on Rails

Pereikime per paprastos "Hello World" programos kūrimo procesą naudojant Ruby on Rails.

Pirmiausia nustatykite naują maršrutą savo programai. Atidarykite config/routes.rb failą ir apibrėžkite pagrindinį maršrutą, kuris nukreipia į hello#index veiksmą:
```
Rails.application.routes.draw do
  root "hello#index"
end
```
Toliau sugeneruokite Hello valdiklį, kad valdytumėte šio maršruto logiką. Vykdykite šią komandą terminale:
```
bin/rails generate controller Hello index --skip-routes
```
Su šia konfigūracija bet koks užklausimas, pateiktas URL keliu /, bus tvarkomas HelloController.
Norėdami parodyti "Hello World" pranešimą, sukurkite vaizdą. Atidarykite failą app/views/hello/index.html.erb ir pakeiskite bet kokį esamą turinį šiuo kodu:
```
<h1>Hello World!</h1>
```
Galiausiai, paleiskite Rails serverį vykdydami žemiau esančią komandą terminale. Tada prisijunkite prie savo kūrimo URL (pavyzdžiui, http://<XXXXXX>.stackhero-network.com:3000), kad pamatytumėte savo programą:
```
bin/rails server -b 0.0.0.0
```
Pirmasis "Hello World" puslapis Ruby on Rails

Sveikiname. Jūs ką tik sukūrėte savo pirmąją Ruby on Rails programą!

Aplinkos kintamųjų valdymas

Aplinkos kintamieji yra būtini norint apsaugoti jautrius duomenis, tokius kaip API raktai ir duomenų bazės slaptažodžiai.

dotenv-rails gem suteikia patogų būdą valdyti aplinkos kintamuosius jūsų kūrimo aplinkoje. Štai žingsniai:

Pridėkite gem į savo Gemfile tinkamose grupėse:

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

Įdiekite gem vykdydami:
```
bundle install
```
Sukurkite .env failą savo projekto šaknyje ir apibrėžkite savo aplinkos kintamuosius. Pavyzdžiui:
```
RAILS_ENV=development
```
Norėdami apsaugoti savo jautrius duomenis, įsitikinkite, kad .env failas yra neįtrauktas į jūsų Git saugyklą. Pridėkite šią eilutę į savo .gitignore:
```
echo '.env*' >> .gitignore
```

Užbaigus šiuos žingsnius, paleiskite Rails serverį iš naujo. Aplinkos kintamieji, apibrėžti .env faile, dabar bus automatiškai pasiekiami jūsų programoje.

Aplinkos kintamieji jūsų kūrimo platformai