Pikaopas

Tämä opas opastaa sinua käyttöönottamaan itse isännöidyn rtCloud-instanssin Linux-palvelimelle alusta alkaen. Lopussa sinulla on toimiva rtCloud, johon pääset käsiksi selaimellasi.

Edellytykset link

Varmista, että palvelimesi täyttää seuraavat vaatimukset ennen aloittamista:

Laitteisto link

Ohjelmisto link

Asenna Docker Ubuntuun:

  curl -fsSL https://get.docker.com | sh
  

Vahvista asennus:

  docker --version
docker compose version
  

Vaihe 1 — Hanki tiedostot link

Kloonaa käyttöönottotietovarasto palvelimellesi:

  git clone ssh://git@rtgit.rta.vn:2224/rtlab/rtwebteam/rta-smart-survey-docker.git rtcloud
cd rtcloud
  

Vaihe 2 — Konfiguroi ympäristö link

Kopioi näytekonfiguraatiotiedosto:

  cp .env.production.sample .env
  

Avaa .env tekstieditorissa ja täytä vaaditut arvot:

  # Tämän käyttöönoton yksilöllinen tunniste (ei välilyöntejä tai erikoismerkkejä)
PROJECT_ID=myproject

# Verkkotunnus tai IP-osoite, josta käyttäjät pääsevät sovellukseen
# Esimerkki: rtcloud.example.com  tai  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Protokolla: käytä "https" jos sinulla on verkkotunnus SSL:llä, muuten "http"
HTTP_PROTOCOL=https

# Vahvat, yksilölliset salasanat — vaihda kaikki kolme ennen käynnistystä
MYSQL_PASSWORD=vaihda_vahva_salasana
MYSQL_ROOT_PASSWORD=vaihda_root_salasana
ADMIN_PASSWORD=vaihda_admin_salasana
  

Tärkeää: Vain .env luetaan Docker Composen toimesta automaattisesti. Älä luo tiedostoa nimeltä .env.production, sillä se aiheuttaisi sekaannusta. ADMIN_PASSWORD otetaan käyttöön vain uuden tietokannan ensimmäisellä käynnistyksellä.

Vaihe 3 — Käynnistä kontit link

Käynnistä kaikki palvelut taustalla:

  docker compose -f docker-compose.production.yml up -d
  

Ensimmäinen käynnistys kestää 3–5 minuuttia, kun Docker:

1. Hakee rtCloud-sovelluskuvan (~1 Gt lataus)
2. Alustaa MySQL-tietokannan
3. Lataa perusskeeman
4. Ajaa kaikki odottavat tietokannan migraatiot

Seuraa käynnistyksen edistymistä reaaliajassa:

  docker compose -f docker-compose.production.yml logs -f rtcloud
  

Odota, kunnes näet tulosteen, joka osoittaa sovelluksen olevan valmis. Voit myös seurata kontin terveydentilaa:

  watch docker compose -f docker-compose.production.yml ps
  

Vaihe 4 — Käytä sovellusta link

Kun molemmat kontit näyttävät Up (healthy), avaa selaimesi:

  http://<PROJECT_URL>:8080
  

Kirjaudu sisään järjestelmänvalvojatilillä:

Vaihda järjestelmänvalvojan salasana välittömästi ensimmäisen kirjautumisen jälkeen tiliasetuksista.

Vaihe 5 — Tarkista kaikki palvelut link

Varmista, että kaikki kontit toimivat ja ovat terveitä:

  docker compose -f docker-compose.production.yml ps
  

Odotettu tulos:

  NAME                    IMAGE                                   STATUS
rtcloud-app             rtawebteam/rta-smartsurvey:...          Up (healthy)
rtcloud-mysql           mysql:8.0                               Up (healthy)
  

Jos kontti näyttää Up (starting) tai Up (unhealthy), odota 30–60 sekuntia ja tarkista uudelleen. MySQL voi kestää jopa minuutin täysin alustuakseen ensimmäisellä käynnistyksellä.

Porttien viite link

MySQL (portti 3306) ja mahdolliset valinnaiset palvelut (Keycloak) ovat vain sisäisiä eivätkä oletuksena näy isännälle.

Seuraavat vaiheet link

rtCloud-instanssisi toimii nyt. Harkitse näitä jatkotoimia:

• Ota HTTPS käyttöön — Osoita verkkotunnus palvelimellesi ja konfiguroi SSL Let’s Encryptillä. Katso automatisoitu HTTPS-asetukset kohdasta Pilvikäyttöönotto.
• Tarkista kaikki asetukset — Selaa Konfigurointiviite virittääksesi käyttöönottosi tuotantoon.
• Aseta SSO — Yhdistä identiteetintarjoaja keskitettyä käyttäjätodennusta varten. Katso SSO-todennus.
• Suunnittele varmuuskopiointisi — Tarkista varmuuskopiointi- ja päivitysmenettelyt kohdasta Ylläpito.