DBaaS:n käyttö komentorivikäyttöliittymällä

DBaaS käyttää taustalla OpenStackia, mikä tarkoittaa, että voit käyttää OpenStackin komentorivikäyttöliittymää samalla tavalla kuin Poudassa. On tärkeää huomata, että vaikka Poudassa käytetään samaa komentoriviä, se ei tarkoita, että olisit yhteydessä Poutaan. Tämä on erityisen tärkeää, jos automatisoit asioita sekä Poudassa että DBaaS:ssa, sillä sinun täytyy muodostaa yhteys eri Keystone-päätepisteisiin.

Käytön aloittaminen

Varmista ensin, että python3 on asennettu.

Asenna sitten komentorivityökalut:

pip3 install python-openstackclient python-troveclient

Sinun täytyy ladata openrc-tiedostosi Pukista ja valita oikea projektinumero. Siirry sitten kohtaan API Access ja Download OpenStack RC file ja valitse OpenStack RC file.
Kun olet ladannut tiedoston, voit ottaa sen käyttöön suorittamalla:
```
source $FILENAME
```
Tämän jälkeen sinun pitäisi voida varmistaa toimivuus listaamalla saatavilla olevat datastoret (saatavilla olevat tietokantatyypit):
```
openstack datastore list
```

Muista, että voit käyttää ohjekomentoa muodossa openstack help database ja valitsinta --help, jotta saat lisätietoa eri komennoista.

Tietokanta-instanssin luominen

Varmista, että olet ottanut käyttöön Pukista lataamasi openrc-tiedoston.
Ennen tietokannan luomista on hyvä tietää, millaisia asetuksia haluat käyttää. Nämä ovat tärkeimmät asiat, jotka kannattaa kerätä:
- Uuden tietokanta-instanssisi name. Tässä esimerkissä käytämme nimeä my_database_instance.
- Mitkä databases haluat luoda. Tässä esimerkissä käytämme vain my_first_database.
- IP addresses, joista haluat käyttää tietokantaasi. Voit yleensä selvittää IP-osoitteesi googlaamalla what is my IP tai käyttämällä komentoriviltä esimerkiksi tällaista sivua:
```
curl ifconfig.me
```
- Flavor, esimerkiksi standard.small . Voit listata saatavilla olevat flavorit komennolla:
```
openstack database flavor list
```
- Datastore, suositus: postgresql. Löydät datastoret komennolla:
```
openstack datastore list
```
- datastore version. Tämä valinnainen valitsin riippuu valitsemastasi datastoresta. Voit turvallisesti jättää sen pois, jos olet tyytyväinen oletusdatastore-versioon, jonka pitäisi aina olla uusin saatavilla oleva versio. Saatavilla olevat datastore-versiot löydät komennolla:
```
openstack datastore version list postgresql
```
- Kuinka suuren volumen GiB-yksiköissä haluat käyttää tietokantasi tallentamiseen. Jos testaat DBaaS:ia ensimmäistä kertaa, 1 GiB riittää hyvin.
- Mitä usernamea ja passwordia haluat käyttää. Tässä esimerkissä käytämme databaseuser ja myPassword568.
Kun olet kerännyt tiedot, joita haluat käyttää tietokantasi luomiseen, voit tehdä sen suorittamalla seuraavan komennon. Päivitä muuttujat tarpeidesi mukaan, erityisesti MY_IP. Voit myös käyttää valitsinta --allowed-cidr useita kertoja lisätäksesi useita IP-osoitteita. Oletuksena tietokanta-instanssit luodaan ilman mitään allowed-cidr-asetusta, mikä tarkoittaa, ettet voi muodostaa yhteyttä tietokantaasi.
```
openstack database instance create my_database_instance \
--flavor standard.small \
--databases my_first_database \
--users databaseuser:myPassword568 \
--datastore postgresql \
--datastore-version 17.0 \
--is-public \
--size 1 \
--allowed-cidr ${MY_IP}/32
```
Jos kohtaat ongelmia, käytä rohkeasti komentoa openstack database instance create --help.
Nyt sinun täytyy odottaa muutama minuutti, kunnes tietokanta-instanssit on luotu ja ne ovat saaneet julkisen IP-osoitteen. Kun instanssit ovat saavuttaneet tilan HEALTHY, julkisen IP-osoitteen pitäisi näkyä. Huomaa, että näkyvissä on sekä yksityinen että julkinen IP-osoite; tarvitset vain julkisen IP-osoitteen. Seuraava komento näyttää instanssin tiedot:
```
openstack database instance show $INSTANCE_ID
```
Jos et ole tyytyväinen palomuuriasetuksiin (--allowed-cidr), voit päivittää niitä komennolla:
```
openstack database instance update $INSTANCE_ID --allowed-cidr $NEW_IP_RANGE
```

On hyvä tarkistaa komentovaihtoehdot komennolla openstack database instance update --help.

Lisätietoa tietokantoihin yhdistämisestä löytyy vasemman reunan navigaation osiosta Databases.

Palauttaminen varmuuskopioista

Voit käyttää samaa komentoa kuin varmuuskopiota luotaessa, mutta palautusta varten sinun täytyy käyttää valitsinta ja sen varmuuskopion tunnistetta, jota haluat käyttää: --backup $BACKUP_ID.

Muita hyödyllisiä komentoja

Luo tietokanta-instanssiin lisätietokanta

Tämä vastaa komentoa CREATE DATABASE db_name;

openstack database db create $INSTANCE_ID $DB_NAME

Käyttäjien lisääminen tietokantaan

Listaa tietokannan olemassa olevat käyttäjät:

openstack database user list $INSTANCE_ID

Luo uusi käyttäjä (--databases on valinnainen):

openstack database user create $INSTANCE_ID $USER_NAME $PASSWORD --databases $DATABASE_NAME

Käyttäjien poistaminen tietokannasta

Käyttäjän poistaminen onnistuu suorittamalla:

openstack database user delete $INSTANCE_ID $USER_NAME

Instanssin poistaminen

Selvitä, minkä tietokanta-instanssin haluat poistaa:

openstack database instance list

Poista instanssit:

openstack database instance delete $INSTANCE_ID

Tuetut toiminnot

Nämä komennot ovat tällä hetkellä saatavilla:

Openstack command	status	Comments
openstack database backup create	Tuettu	Kaikkia valitsimia ei ole testattu
openstack database backup delete	Tuettu	Saatetaan poistaa tulevaisuudessa
openstack database backup execution delete	Ei saatavilla	Ei tuettu DBaaS:ssa
openstack database backup list	Tuettu
openstack database backup list instance	Tuettu
openstack database backup show	Tuettu
openstack database backup strategy create	Ei saatavilla	Vain ylläpitäjille
openstack database backup strategy delete	Ei saatavilla	Vain ylläpitäjille
openstack database backup strategy list	Ei saatavilla	Vain ylläpitäjille
openstack database cluster create	Ei saatavilla	Ei vielä tutkittu
openstack database cluster delete	Ei saatavilla	Ei vielä tutkittu
openstack database cluster force delete	Ei saatavilla	Ei vielä tutkittu
openstack database cluster grow	Ei saatavilla	Ei vielä tutkittu
openstack database cluster list	Ei saatavilla	Ei vielä tutkittu
openstack database cluster list instances	Ei saatavilla	Ei vielä tutkittu
openstack database cluster modules	Ei saatavilla	Ei vielä tutkittu
openstack database cluster reset status	Ei saatavilla	Ei vielä tutkittu
openstack database cluster show	Ei saatavilla	Ei vielä tutkittu
openstack database cluster shrink	Ei saatavilla	Ei vielä tutkittu
openstack database cluster upgrade	Ei saatavilla	Ei vielä tutkittu
openstack database configuration attach	Tuettu
openstack database configuration create	Tuettu
openstack database configuration default	Tuettu
openstack database configuration delete	Tuettu
openstack database configuration detach	Tuettu
openstack database configuration instances	Tuettu
openstack database configuration list	Tuettu
openstack database configuration parameter list	Tuettu
openstack database configuration parameter set	Tuettu
openstack database configuration parameter show	Tuettu
openstack database configuration set	Tuettu
openstack database configuration show	Tuettu
openstack database db create	Tuettu
openstack database db delete	Tuettu
openstack database db list	Tuettu
openstack database flavor list	Tuettu
openstack database flavor show	Tuettu
openstack database instance create	Tuettu
openstack database instance delete	Tuettu
openstack database instance detach	Ei saatavilla
openstack database instance eject	Ei saatavilla
openstack database instance force delete	Vain ylläpitäjille
openstack database instance list	Tuettu
openstack database instance promote	Ei saatavilla
openstack database instance reboot	Vain ylläpitäjille
openstack database instance rebuild	Vain ylläpitäjille
openstack database instance reset status	Vain ylläpitäjille
openstack database instance resize flavor	Tuettu	Huomaa, että tämä aiheuttaa käyttökatkon
openstack database instance resize volume	Ei tuettu	Ei toimi ilman ylläpitäjän toimenpiteitä
openstack database instance restart	Tuettu	Käynnistää tietokantasäiliön uudelleen - hyöty on rajallinen
openstack database instance show	Tuettu
openstack database instance update	Tuettu	Vain osa valitsimista on tuettu. Tuetut valitsimet: --name , --allowed-cidr
openstack database instance upgrade	Tuettu	Päivittää tietokanta-instanssin. Tämä komento aiheuttaa käyttökatkon.
openstack database limit list	Tuettu
openstack database log list	Tuettu	Mahdollistaa instanssilokien tarkastelun. Tämä API on epävakaa ja saattaa muuttua, eikä se tee samaa asiaa kuin upstream
openstack database log save	Ei saatavilla
openstack database log set	Ei saatavilla
openstack database log show	Ei saatavilla
openstack database log tail	Ei saatavilla
openstack database quota show	Vain ylläpitäjille
openstack database quota update	Vain ylläpitäjille
openstack database root disable	Tuettu
openstack database root enable	Tuettu	Useimmissa tapauksissa root enable ei ole tarpeen, mutta jos haluat tehdä edistyneitä käyttöoikeusmäärityksiä, se on todennäköisesti tarpeen.
openstack database root show	Tuettu
openstack database user create	Tuettu
openstack database user delete	Tuettu
openstack database user grant access	Tuettu
openstack database user list	Tuettu
openstack database user revoke access	Tuettu
openstack database user show	Tuettu
openstack database user show access	Tuettu
openstack database user update attributes	Tuettu
openstack datastore delete	Vain ylläpitäjille
openstack datastore list	Tuettu
openstack datastore show	Tuettu
openstack datastore version create	Vain ylläpitäjille
openstack datastore version delete	Vain ylläpitäjille
openstack datastore version list	Tuettu
openstack datastore version set	Vain ylläpitäjille
openstack datastore version show	Tuettu