# Jak zacząć?

# Krok 1 - posiadanie projektu Google Cloud Platform

Platforma WitCloud integruje się z Twoim projektem Google Cloud Platform. Wyniki transformacji i obliczeń uruchamianych przez WitCloud są zapisywane w zbiorach danych BigQuery w Twoim projekcie Google Cloud, którego jesteś właścicielem. Dzięki temu sam decydujesz do czego te dane wykorzystasz i komu je udostępnisz. W celu korzystania z platformy musisz więc posiadać projekt w Google Cloud Platform.

Jeżeli nie masz jeszcze projektu na platformie Google Cloud, nie ma się czym martwić - założenie takiego projektu trwa kilka minut!

# Konto połączone z usługami Google

Rozwiń, aby zobaczyć szczegóły

Aby utworzyć projekt na Google Cloud Platform potrzebne jest konto powiązanie z usługami Google.

Jeżeli nie masz konta Google, możesz je założyć na 2 sposby:

  • Połączenie Twojego adresu e-mail z usługami Google

  • Stworzenie nowego konta Google

Można je założyc za darmo pod tym adresem https://accounts.google.com/SignUp (opens new window)

image alt text

# Rejestracja w Google Cloud Platform

Rozwiń, aby zobaczyć szczegóły

Odwiedź stronę Google Cloud https://cloud.google.com/ (opens new window) i nacisnij przycisk darmowej rejestracji

image alt text

Należy wypełnić formularz rejestracyjny informacjami odnośnie firmy oraz płatności - każdy nowy użytkownik dostaje na start 300$ do wykorzystania przez 90 dni korzystania z Google Cloud Platform.

image alt textimage alt textimage alt text

# Utworzenie projektu w Google Cloud Platform

Rozwiń, aby zobaczyć szczegóły

Po utworzeniu konta na Google Cloud Platform, należy założyc projekt w konsoli Google Cloud Platform https://console.cloud.google.com (opens new window), w lewym górnym rogu rozwijamy listę projektów

image alt text

Następnie w oknie które się pojawi naciskamy na przycisk tworzenia nowego projektu

image alt text

W następnym kroku konfigurujemy projekt. Wystarczy wypełnić pole z nazwą projektu, jeśli email który tworzy projekt jest w jakiejś organizacji G-suite, projekt będzie dostępny również pod tą organizacja dla całej grupy. Jako nawę proponujemy "WitCloud - NAZWA_FIRMY_LUB_STRONY", ale oczywiście możena wybrać dowolną inną nazwę. Po wypełnieniu formularza naciskamy przycisk tworzenia projektu.

image alt text

# Krok 2 - założenie konta i utworzenie projektu w WitCloud Platform

Rejestracja w WitCloud jest bardzo prosta.

Można jej dokonać tutaj: link do rejestracji na platformie (opens new window)

Rekomendowane jest utworzenie konta w platformie przez 1 osobę, a nastepnie wysłanie zaproszeń do projektu innym osobom z organizacji.

# Utworzenie projektu WitCloud po rejestracji

Rozwiń, aby zobaczyć szczegóły

Po skutecznej rejestracji, weryfikacji adresu e-mail oraz pierwszym zalogowaniu się do panelu WitCloud, można zobaczyć poniższy widok:

image alt text

W pierwszym kroku należy wpisać nazwę projektu **(1). **W polu (2) należy wybrać preferowaną lokalizację w której będą przechowywane dane tworzonego projektu WitCloud. Obecnie, dostępne do wyboru są dwie lokalizacje: EU (European Union) oraz US (United States).

Note: lokalizacja jest bardzo ważnym aspektem konfiguracji projektu WitCloud. W trakcie tworzenia projektu, platforma WitCloud automatycznie utworzy BigQuery dataset oraz Storage bucket w wybranej lokalizacji. Należy uwzględnić ten fakt w dalszym korzystaniu z danych, dostarczanych przez WitCloud.

Obecnie, zmiana lokalizacji danych projektu WitCloud po konfiguracji nie jest możliwa. Warto więc wybrać właściwą.

Po dokonaniu wyboru wcisnąć przycisk Next (3).

Pojawi się widok konfiguracji dostępu:

image alt text

W polu (1) znajduje się Dedicated Service Account - adres email wygenerowany do obsługi danego projektu WitCloud. Należy użyć go jako adresu użytkownika, któremu nadajemy stosowne uprawnienia w Google Cloud Platform.

Instrukcje nadawania dostępu znajdziesz tu: link.

# Autoryzacja projektu WitCloud z Twoim projektem na Google Cloud Platform

W tym celu należy zalogować się do platformy Google Cloud https://console.cloud.google.com/ (opens new window).

Jeśli dedykowany dla WitCloud projekt na GCP nie został jeszcze utworzony, tu przeczytasz jak go stworzyć.

Rozwiń, aby zobaczyć szczegóły

W panelu Google Cloud Platform, w lewym górnym rogu wybieramy projekt, który chcemy zautoryzować z platformą WitCloud.

Następnie z menu rozwijanego w lewym górnym rogu wybieramy opcje IAM & Admin (Administracja) a następnie IAM

image alt text

Następnie naciskamy na przycisk Dodawania dostępu

image alt text

Jako użytkownika podajemy konto wygenerowane przez aplikację WitCloud.

Proces uzyskania dedykowanego adresu service account opisaliśmy w poprzednim kroku kroku

W polach dostępu uzupełniamy 3 role:

BigQuery User

BigQuery Data Editor

Storage Admin

W polskim interfejsie powyższe role noszą nazwy Edytujący dane BigQuery, Użytkownik BigQuery oraz Administrator pamięci masowej

Wyszukiwanie ról można sobie ułatwić korzystając z wyszukiwarki.

image alt text

Naciskamy przycisk save i gotowe!

Wracamy do WitClouda. Po dodaniu uprawnień do projektu na Google Cloud Platform, i kliknięciu przycisku **(2) **refresh w oknie **(3) **pojawią się projekty do których mamy dostęp.

image alt text

Proces aktualizacji dostępów może zająć chwilę więc jeśli nie pojawiają się żadne projekty w oknie (3) należy odczekać i ponownie kliknąć przycisk (2) Refresh. Proces uaktualnienia powinien zająć niecałą minutę.

Po wypełnieniu wszystkich niezbędnych pól należy kliknąć przycisk ** Submit**.

Pojawia się informacja o założeniu projektu - gratulacje!

image alt text

Jeśli utworzenie nowego projektu powiodło się, można zobaczyć go na liście (10):

image alt text

Z listy (10) także można wybrać inny projekt WitCloud, jeśli taki został stworzony do tej pory.

W razie potrzeby kolejny projekt można założyć z poziomu panelu WitCloud:

image alt text

W menu po lewej, należy przejść do zakładki Settings (1), następnie wejść do zakładki Projects (2), widok którego zawiera przycisk Add new Project (3). Po kliknięciu przycisku (3) otworzy się widok konfiguracji nowego projektu WitCloud.

Last updated: 2/3/2021, 10:28:38 AM