Aby zarejestrować organizację, musisz utworzyć plik konfiguracji rejestracji, a następnie przekazać go
do polecenia setup-org. Każdy z tych kroków jest opisany w kolejnych sekcjach.
Informacje o rejestrowaniu organizacji za pomocą interfejsu API zarządzania Google Analytics znajdziesz w artykule Tworzenie organizacji, środowiska i hosta wirtualnego.
Tworzenie pliku konfiguracji rejestracji
Ta sekcja zawiera przykładowy plik konfiguracji rejestracji organizacji za pomocą
setup-org.
Skopiuj ten przykład i w razie potrzeby zmodyfikuj go na potrzeby swojej organizacji:
# Specify the IP or DNS name of the Management Server. IP1=MANAGEMENT_SERVER_IP_ADDRESS MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=admin_password # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user # Org admin password must be at least 8 characters long and contain one uppercase # letter, one lowercase letter, and one digit or special character USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # lowercase only # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
Pamiętaj, że:
- W przypadku
VHOST_ALIAS, jeśli masz już rekord DNS, którego będziesz używać do uzyskiwania dostępu do hosta wirtualnego, podaj alias hosta i opcjonalnie port, np. „myapi.example.com”. Jeśli nie masz jeszcze rekordu DNS rekord, możesz użyć adresu IP routera.
Więcej informacji o konfigurowaniu hosta wirtualnego znajdziesz w artykule Setting up a virtual host.
- Więcej informacji o tworzeniu pliku JAR, i innych aspektach konfigurowania TLS/SSL znajdziesz w artykule Magazyny kluczy i magazyny zaufanych certyfikatów oraz Konfigurowanie dostępu TLS do interfejsu API w chmurze prywatnej.
- Więcej informacji o konfigurowaniu hostów wirtualnych znajdziesz w artykule Konfigurowanie dostępu TLS do interfejsu API w chmurze prywatnej.
- Nie możesz utworzyć 2 organizacji o tej samej nazwie. W takim przypadku druga próba utworzenia organizacji zakończy się niepowodzeniem.
Uruchamianie polecenia setup-org
Po utworzeniu pliku konfiguracji rejestracji przekaż go do skryptu setup-org, aby przeprowadzić proces rejestracji. Skrypt musisz uruchomić na węźle serwera zarządzania.
Podczas rejestracji organizacji skrypt setup-org wykonuje te czynności:
- Tworzy nową organizację.
- Tworzy środowisko.
- Tworzy hosta wirtualnego dla środowiska.
- Ustawia określonego użytkownika jako administratora organizacji. Pamiętaj:
- Możesz użyć istniejącego użytkownika lub utworzyć nowego administratora organizacji.
- Administrator organizacji nie może być tym samym użytkownikiem co administrator systemu.
- Łączy organizację z podem „gateway”. (Jest to ustawienie domyślne, którego nie można zmienić).
- Łączy środowisko ze wszystkimi procesorami komunikatów.
- Włącza statystyki.
Aby uruchomić polecenie setup-org:
- Zainstaluj
apigee-provisionna węźle serwera zarządzania:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- Uruchom skrypt
setup-orgna węźle serwera zarządzania i wskaż plik konfiguracji utworzony w sekcji Tworzenie pliku konfiguracji rejestracji:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Plik konfiguracji musi być czytelny dla użytkownika „apigee”.
- Sprawdź, czy rejestracja organizacji się powiodła. Jednym ze sposobów jest zalogowanie się
w nowym interfejsie Edge, wysyłając w przeglądarce to żądanie URL:
http://IP_address:3001
Gdzie IP_address to adres IP serwera, na którym zainstalowano nowy interfejs Edge.
Dodatkowe kroki weryfikacji znajdziesz w sekcji Sprawdzanie rejestracji.
- Utwórz pierwszy serwer proxy.
Sprawdzanie rejestracji
Po zakończeniu rejestracji sprawdź stan systemu, wykonując te
curl polecenia na węźle serwera zarządzania:
- Aby sprawdzić stan użytkownika i organizacji na serwerze zarządzania, wykonaj te
polecenia:
curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizationscurl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations/org_name/deployments - Aby sprawdzić statystyki, wykonaj to polecenie:
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- Aby sprawdzić stan bazy danych PostgreSQL, wykonaj te polecenia na węźle 2
(jak pokazano w topologiach instalacji):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
W wierszu poleceń wpisz to polecenie, aby wyświetlić tabelę statystyk dla swojej organizacji:
\d analytics."org_name.env_name.fact"
Aby zamknąć psql, użyj tego polecenia:
\q
- Otwórz nowy interfejs Edge w przeglądarce. Pamiętaj, że adres URL konsoli zarządzania został zapisany na końcu instalacji.
- Uruchom preferowaną przeglądarkę i wpisz adres URL nowego interfejsu Edge. Powinien on wyglądać podobnie do tego, gdzie adres IP to adres IP węzła 1 (jak pokazano wtopologiach instalacji) lub dowolnego węzła, na którym zainstalowano nowy interfejs Edge w przypadku konfiguracji alternatywnych:
http://192.168.56.111:3001
3001 to domyślny numer portu używany przez nowy interfejs Edge.
Jeśli uruchamiasz przeglądarkę bezpośrednio na serwerze, na którym hostowany jest nowy interfejs Edge, możesz użyć adresu URL w tym formacie:
http://localhost:3001
- Na stronie logowania do konsoli podaj nazwę użytkownika i hasło administratora systemu Apigee.
- Uruchom preferowaną przeglądarkę i wpisz adres URL nowego interfejsu Edge. Powinien on wyglądać podobnie do tego, gdzie adres IP to adres IP węzła 1 (jak pokazano wtopologiach instalacji) lub dowolnego węzła, na którym zainstalowano nowy interfejs Edge w przypadku konfiguracji alternatywnych:
- Zarejestruj nowe konto użytkownika Apigee i użyj nowych danych logowania. Na stronie logowania do konsoli kliknij przycisk Zaloguj się.
Przeglądarka przekieruje Cię na stronę
http://192.168.56.111:3001/edgei otworzy panel, który umożliwia skonfigurowanie utworzonej organizacji (jeśli logujesz się za pomocą danych logowania administratora Apigee).
Tworzenie pierwszego serwera proxy
Po zarejestrowaniu nowej organizacji i sprawdzeniu, czy proces rejestracji się powiódł, możesz utworzyć pierwszy serwer proxy. Więcej informacji znajdziesz w artykule Tworzenie pierwszego serwera proxy interfejsu API.
Inne przydatne materiały: