Edge dla chmury prywatnej w wersji 4.19.01
Aby wprowadzić organizację, musisz utworzyć plik konfiguracji wprowadzenia, a następnie przekazać go do polecenia setup-org. Każdy z tych kroków został opisany w kolejnych sekcjach.
Informacje o używaniu interfejsu API zarządzania Google Analytics do wprowadzania organizacji znajdziesz w artykule o tworzeniu organizacji, środowiska i hosta wirtualnego.
Tworzenie pliku konfiguracji wprowadzenia
Ta sekcja zawiera przykładowy plik konfiguracji do wprowadzania organizacji za pomocą setup-org.
Skopiuj poniższy przykład i zmodyfikuj go zgodnie z potrzebami organizacji:
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. 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.
Uwaga:
- Jeśli w przypadku
VHOST_ALIASmasz już rekord DNS, którego będziesz używać do uzyskiwania dostępu do hosta wirtualnego, podaj alias hosta i opcjonalnie port, na przykład „myapi.example.com”. Jeśli nie masz jeszcze rekordu DNS, możesz użyć adresu IP routera.
Więcej informacji o konfigurowaniu hosta wirtualnego znajdziesz w artykule Konfigurowanie hosta wirtualnego.
- Więcej informacji o tworzeniu pliku JAR i innych aspektach konfigurowania TLS/SSL znajdziesz w artykułach o magazynach kluczy i magazynach zaufanych certyfikatów oraz konfigurowaniu 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 zakończy się niepowodzeniem.
Uruchom setup-org
Po utworzeniu pliku konfiguracji wprowadzenia przekaż go do skryptu setup-org, aby przeprowadzić proces wprowadzenia. Skrypt musisz uruchomić na węźle serwera zarządzania.
Podczas rejestrowania 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. Uwaga:
- Możesz użyć istniejącego konta użytkownika lub utworzyć nowe konto dla administratora organizacji.
- Administrator organizacji nie może być administratorem systemu.
- Powiązuje organizację z podem „gateway”. (jest to ustawienie domyślne i nie można go zmienić).
- Powiązuje środowisko ze wszystkimi procesorami komunikatów.
- Włącza statystyki.
Aby wykonać setup-org:
- Zainstaluj
apigee-provisionna węźle serwera zarządzania:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- Uruchom skrypt
setup-orgw węźle serwera zarządzania i wskaż plik konfiguracji utworzony w sekcji Tworzenie pliku konfiguracji wprowadzenia:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Plik konfiguracji musi być możliwy do odczytania przez użytkownika „apigee”.
- Sprawdź, czy organizacja została prawidłowo zarejestrowana. Jednym ze sposobów jest zalogowanie się w interfejsie przez wysłanie żądania pod ten adres URL w przeglądarce:
http://IP_address:9000/login
Gdzie IP_address to adres IP serwera, na którym zainstalowano interfejs Edge.
Dodatkowe instrukcje znajdziesz w sekcji Weryfikowanie rejestracji.
- Utwórz pierwsze proxy
Sprawdzanie rejestracji
Po zakończeniu procesu wprowadzania sprawdź stan systemu, uruchamiając te polecenia curl w węźle serwera zarządzania:
- Sprawdź stan użytkownika i organizacji na serwerze zarządzania, wykonując 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 - Sprawdź statystyki, wykonując to polecenie:
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- Sprawdź stan bazy danych PostgreSQL, wykonując te polecenia w węźle 2 (jak pokazano w topologiach instalacji):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
W wierszu polecenia wpisz to polecenie, aby wyświetlić tabelę statystyk organizacji:
\d analytics."org_name.env_name.fact"
Aby wyjść z psql, użyj tego polecenia:
\q
- Uzyskaj dostęp do interfejsu Apigee Edge za pomocą przeglądarki. Pamiętaj, że adres URL konsoli zarządzania został już zapisany na końcu instalacji.
- Uruchom preferowaną przeglądarkę i wpisz adres URL interfejsu Edge. Wygląda on podobnie do tego, gdzie adres IP jest adresem węzła 1 (jak pokazano w topologiach instalacji) lub dowolnego węzła, na którym zainstalowano interfejs użytkownika dla konfiguracji alternatywnych:
http://192.168.56.111:9000/login
9000 to numer portu używany przez interfejs użytkownika.
Jeśli uruchamiasz przeglądarkę bezpośrednio na serwerze hostującym interfejs Edge, możesz użyć adresu URL w formacie:
http://localhost:9000/login
- Na stronie logowania do konsoli podaj nazwę użytkownika i hasło administratora systemu Apigee.
- Uruchom preferowaną przeglądarkę i wpisz adres URL interfejsu Edge. Wygląda on podobnie do tego, gdzie adres IP jest adresem węzła 1 (jak pokazano w topologiach instalacji) lub dowolnego węzła, na którym zainstalowano interfejs użytkownika dla konfiguracji alternatywnych:
- Zarejestruj nowe konto użytkownika Apigee i zaloguj się przy użyciu nowych danych logowania. Na stronie logowania w konsoli kliknij przycisk Zaloguj się.
Przeglądarka przekieruje Cię na stronę
http://192.168.56.111:9000/platform/#/org_name/i otworzy panel, w którym możesz skonfigurować utworzoną organizację (jeśli zalogujesz się przy użyciu danych logowania administratora Apigee).
Tworzenie pierwszego serwera proxy
Po wprowadzeniu nowej organizacji i sprawdzeniu, czy proces wprowadzenia zakończył się powodzeniem, możesz utworzyć pierwszy serwer proxy. Więcej informacji znajdziesz w artykule Tworzenie pierwszego serwera proxy interfejsu API.
Inne przydatne materiały: