Edge for Private Cloud w wersji 4.18.05
Aby przeprowadzić proces wdrażania, użyj skryptu setup-org
. Skrypt musisz uruchomić na węźle serwera zarządzania.
Aby zarejestrować organizację:
- Zainstaluj
apigee-provision
na węźle serwera zarządzania:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- Uruchom skrypt
setup-org
w węźle serwera zarządzania:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Plik konfiguracji musi być czytelny dla użytkownika „apigee”. Przykładowy plik konfiguracji znajdziesz w artykule Plik konfiguracji w procesie rejestracji.
- Sprawdź, czy organizacja została dodana. Jednym ze sposobów jest zalogowanie się w interfejsie, prosząc o adres URL w przeglądarce:
http://IP_address:9000/login
Gdzie IP_address to adres IP serwera, na którym zainstalowano interfejs użytkownika Edge.
Dodatkowe kroki weryfikacji znajdziesz w artykule Weryfikacja rejestracji.
- Utwórz pierwsze proxy!
Plik konfiguracji wdrożenia
Aby przeprowadzić konfigurację w trybie cichy za pomocą skryptu setup-org
, prześlij plik konfiguracji z opcją -f
, jak pokazano w tym przykładzie:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Ta sekcja zawiera przykładowy plik konfiguracji do wprowadzenia organizacji przy użyciu setup-org
.
Podczas wdrażania organizacji skrypt setup-org
wykonuje te czynności:
- Tworzy nową organizację.
- Tworzy środowisko.
- Tworzy hosta wirtualnego dla środowiska.
- Ustawia wskazanego użytkownika jako administratora organizacji. Pamiętaj, że:
- Możesz użyć istniejącego użytkownika lub utworzyć nowego dla administratora organizacji.
- Administrator organizacji nie może być tą samą osobą co administrator systemu.
- Powiązuje organizację z podzbiorem „gateway”. (jest to ustawienie domyślne i nie można go zmienić).
- Powiązuje środowisko ze wszystkimi procesorami wiadomości.
- Włącza funkcję analityki.
Skopiuj poniższy przykład i w razie potrzeby wprowadź zmiany, aby wprowadzić organizację:
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.
Uwagi:
- W przypadku
VHOST_ALIAS
, jeśli masz już rekord DNS, którego będziesz używać do uzyskiwania dostępu do hosta wirtualnego, określ alias hosta i opcjonalnie port, np. „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.
- Informacje o konfiguracji TLS/SSL znajdziesz w artykułach Keystores and Truststores (sklepy z kluczami i sklepy z zaufanymi katalogami) oraz Konfigurowanie dostępu TLS do interfejsu API w chmurze prywatnej (tworzenie pliku JAR i inne aspekty konfigurowania TLS/SSL).
- Więcej informacji o konfigurowaniu hostów wirtualnych znajdziesz w artykule Konfigurowanie dostępu TLS do interfejsu API w Private Cloud.
- Nie możesz utworzyć 2 organizacji o tej samej nazwie. W takim przypadku drugie utworzenie nie powiedzie się.
Więcej informacji o używaniu interfejsu API do zarządzania do rejestracji organizacji znajdziesz w artykule o tworzeniu organizacji, środowiska i hosta wirtualnego.
weryfikowanie procesu wdrożenia,
Po zakończeniu procesu wdrażania sprawdź stan systemu, wykonując te polecenia CURL na 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/organizations
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations/org_name/deployments
- Aby sprawdzić statystyki, uruchom 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 na węźle 2 (jak pokazano na topologii instalacji):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
Aby wyświetlić tabelę analityczną organizacji, w wierszu poleceń wpisz to polecenie:
\d analytics."org_name.env_name.fact"
Aby zamknąć psql, użyj tego polecenia:
\q
- Uzyskaj dostęp do interfejsu Apigee Edge w przeglądarce. Pamiętaj, że na końcu instalacji został już zapisany adres URL konsoli zarządzania.
- Uruchom preferowaną przeglądarkę i wpisz adres URL interfejsu Edge. Wygląda to podobnie do poniższego przykładu, gdzie adres IP dotyczy węzła 1 (zgodnie z topologią instalacji) lub dowolnego węzła, w którym został zainstalowany interfejs użytkownika na potrzeby 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 to podobnie do poniższego przykładu, gdzie adres IP dotyczy węzła 1 (zgodnie z topologią instalacji) lub dowolnego węzła, w którym został zainstalowany interfejs użytkownika na potrzeby konfiguracji alternatywnych:
- Zarejestruj nowe konto użytkownika Apigee i użyj nowych danych logowania, aby się zalogować. 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 zarejestrowaniu nowej organizacji i sprawdzeniu, czy proces rejestracji przebiegł pomyślnie, możesz utworzyć pierwsze konto zastępcze. Więcej informacji znajdziesz w artykule Tworzenie pierwszego serwera proxy interfejsu API.
Inne przydatne materiały: