Aby zarejestrować organizację, musisz utworzyć plik konfiguracji wprowadzenia, a następnie go przekazać
do polecenia setup-org
. Każdy z nich opisujemy w sekcjach, w których
obserwuj.
Informacje o korzystaniu z interfejsu API do zarządzania w celu rejestracji organizacji znajdziesz w materiałach na temat Utworzenie organizacji, i hosta wirtualnego.
Tworzenie pliku konfiguracji wprowadzenia
Ta sekcja zawiera przykładowy plik konfiguracji do wprowadzania organizacji z
setup-org
Skopiuj poniższy przykład i wprowadź odpowiednie zmiany w swojej 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:
- W przypadku usługi
VHOST_ALIAS
, jeśli ma już rekord DNS, którego użyjesz do uzyskania dostępu do hosta wirtualnego, określ hosta alias i opcjonalnie port, np. „myapi.example.com”. Jeśli nie masz jeszcze systemu DNS rekordu, możesz użyć adresu IP routera.
Więcej informacji na temat konfigurowania hosta wirtualnego można znaleźć w sekcji Ustawienie na hoście wirtualnym.
- Informacje o konfiguracji TLS/SSL znajdziesz w sekcji Magazyny kluczy Magazyny zaufania i Konfigurowanie Dostęp TLS do interfejsu API w chmurze Private Cloud w celu uzyskania dodatkowych informacji o tworzeniu pliku JAR oraz inne aspekty konfigurowania TLS/SSL.
- Więcej informacji o konfigurowaniu hostów wirtualnych znajdziesz w artykule Konfigurowanie dostępu TLS do API dla Private Cloud.
- Nie można utworzyć dwóch organizacji o tej samej nazwie. W takim przypadku drugie utworzenie niepowodzenie.
Wykonaj konfigurację setup-org
Po utworzeniu pliku konfiguracji wprowadzenia przekaż go do setup-org
skrypt wdrożenia. Musisz uruchomić skrypt na serwerze zarządzania
do węzła.
Podczas wprowadzania 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, że:
- Możesz użyć istniejącego użytkownika lub utworzyć nowego dla administratora organizacji.
- Administrator organizacji nie może być taki sam jak administrator systemu sys.
- Wiąże organizację z „bramą” pod. (Jest to ustawienie domyślne i nie może changed.)
- Łączy środowisko ze wszystkimi procesorami wiadomości.
- Włącza statystyki.
Aby wykonać polecenie setup-org
:
- Zainstaluj
apigee-provision
w 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 i skieruj go do plik konfiguracji utworzony w kroku Tworzenie konfiguracji wprowadzającej :/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Plik konfiguracji musi być czytelny dla „apigee” użytkownika.
- Sprawdź, czy organizacja została zarejestrowana. Jednym ze sposobów jest zalogowanie
przez wysłanie żądania w przeglądarce o ten adres URL:
http://IP_address:9000/login
Gdzie IP_address to adres IP serwera, na którym zainstalowano Edge Interfejs.
Dodatkowe kroki weryfikacji znajdziesz w artykule Weryfikacja rejestracji.
- Utwórz swój pierwszy serwer proxy.
Weryfikacja wprowadzenia
Po zakończeniu rejestracji sprawdź stan systemu, wykonując następujące polecenia:
Polecenia curl
w węźle serwera zarządzania:
- Sprawdź stan użytkownika i organizacji na serwerze zarządzania, wykonując następujące polecenie
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
- 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 w węźle Node 2 te polecenia
(jak pokazano w topologach instalacji):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
W wierszu polecenia wpisz następujące polecenie, aby wyświetlić tabelę analityczną organizacja:
\d analytics."org_name.env_name.fact"
Aby wyjść z psql, użyj tego polecenia:
\q
- Uzyskaj dostęp do interfejsu Apigee Edge w przeglądarce. Pamiętaj, że zanotowałeś już
adresu URL konsoli zarządzania na końcu instalacji.
- Uruchom preferowaną przeglądarkę i wpisz adres URL interfejsu Edge. Wygląda podobnie do
gdzie adres IP jest dla węzła 1 (jak pokazano w polu
topologie instalacji) lub
w zależności od tego, na którym węźle
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żna użyć adresu URL w formacie:
http://localhost:9000/login
- Na stronie logowania w konsoli podaj nazwę użytkownika i hasło administratora systemu Apigee.
- Uruchom preferowaną przeglądarkę i wpisz adres URL interfejsu Edge. Wygląda podobnie do
gdzie adres IP jest dla węzła 1 (jak pokazano w polu
topologie instalacji) lub
w zależności od tego, na którym węźle
zainstalowano interfejs użytkownika dla konfiguracji alternatywnych:
- Zarejestruj nowe konto użytkownika Apigee i użyj nowych danych logowania, aby się zalogować. Dzień
stronie logowania w konsoli, kliknij przycisk Zaloguj się.
Przeglądarka przekierowuje na stronę
http://192.168.56.111:9000/platform/#/org_name/
i otwiera panel, który pozwala skonfigurować utworzoną organizację (jeśli przy użyciu danych logowania administratora Apigee).
Tworzenie pierwszego serwera proxy
Gdy już zarejestrujesz nową organizację i potwierdzisz, że proces wdrażania był zakończony możesz utworzyć swój pierwszy serwer proxy. Więcej informacji znajdziesz w artykule Tworzenie pierwszego serwera proxy interfejsu API.
Inne przydatne zasoby: