Aby zarejestrować organizację, musisz utworzyć plik konfiguracji wprowadzenia i przekazać go do polecenia setup-org
. Opis każdego z tych kroków znajdziesz w kolejnych sekcjach.
Informacje o tym, jak zarejestrować organizację za pomocą interfejsu Management API, znajdziesz w artykule o tworzeniu organizacji, środowiska i hosta wirtualnego.
Tworzenie pliku konfiguracji wprowadzenia
Ta sekcja zawiera przykładowy plik konfiguracji umożliwiający wprowadzenie organizacji za pomocą setup-org
.
Skopiuj poniższy przykład i w razie potrzeby wprowadź 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.
Pamiętaj, że:
- Jeśli w przypadku
VHOST_ALIAS
masz 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.
- Informacje o konfiguracji TLS/SSL znajdziesz w sekcjach Magazyny i magazyny zaufania oraz Konfigurowanie dostępu TLS do interfejsu API w chmurze prywatnej, w którym znajdziesz więcej informacji o tworzeniu pliku JAR i innych aspektach konfigurowania protokołu TLS/SSL.
- 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 drugie utworzenie się nie uda.
Uruchom konfigurację-org
Po utworzeniu pliku konfiguracji wprowadzenia przekazujesz go do skryptu setup-org
, aby go przeprowadzić. Musisz uruchomić skrypt w węźle serwera zarządzania.
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. Uwaga:
- Możesz użyć istniejącego konta użytkownika lub utworzyć nowe konto dla administratora organizacji.
- Administrator organizacji nie może być tym samym administratorem organizacji.
- Wiąże organizację z podem „gateway”. Jest to ustawienie domyślne i nie można go zmienić.
- Przypisuje środowisko ze wszystkimi podmiotami przetwarzającymi wiadomości.
- Umożliwia korzystanie ze statystyk.
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 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ć czytelny dla użytkownika „apigee”.
- Sprawdź, czy udało Ci się zarejestrować organizację. Możesz to zrobić na przykład, logując się w interfejsie użytkownika, wysyłając żądanie dotyczące tego adresu URL w przeglądarce:
http://IP_address:9000/login
Gdzie IP_address to adres IP serwera, na którym zainstalowano interfejs Edge.
Dodatkowe kroki weryfikacji znajdziesz w artykule Weryfikowanie rejestracji.
- Utwórz pierwszy serwer proxy.
Weryfikacja wprowadzenia
Po zakończeniu wprowadzenia 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/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 2 te polecenia (jak pokazano w topologii instalacji):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
W wierszu polecenia wpisz to polecenie, aby wyświetlić tabelę Analytics w organizacji:
\d analytics."org_name.env_name.fact"
Użyj tego polecenia, aby zamknąć psql:
\q
- Uzyskaj dostęp do interfejsu Apigee Edge w przeglądarce. Pamiętaj, że na końcu instalacji został zanotowany adres URL konsoli zarządzania.
- Uruchom preferowaną przeglądarkę i wpisz adres URL interfejsu Edge. Wygląda to podobnie do tego, gdzie adres IP wskazuje węzeł 1 (jak widać w topologii instalacji) lub węzła, w którym zainstalowano interfejs użytkownika na potrzeby alternatywnych konfiguracji:
http://192.168.56.111:9000/login
9000 to numer portu używany w interfejsie użytkownika.
Jeśli uruchamiasz przeglądarkę bezpośrednio na serwerze, na którym jest hostowany interfejs Edge, możesz użyć adresu URL w formacie:
http://localhost:9000/login
- Na stronie logowania się w 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 tego, gdzie adres IP wskazuje węzeł 1 (jak widać w topologii instalacji) lub węzła, w którym zainstalowano interfejs użytkownika na potrzeby alternatywnych konfiguracji:
- Zarejestruj nowe konto użytkownika Apigee i zaloguj się, używając nowych danych logowania. Na stronie logowania się w konsoli kliknij przycisk Zaloguj się.
Przeglądarka przekierowuje do
http://192.168.56.111:9000/platform/#/org_name/
i otwiera panel, który umożliwia skonfigurowanie utworzonej organizacji (jeśli użytkownik zalogował się przy użyciu danych logowania administratora Apigee).
Utwórz pierwszy serwer proxy
Po zarejestrowaniu nowej organizacji i sprawdzeniu, czy proces wprowadzenia przebiegł pomyślnie, możesz utworzyć pierwszy serwer proxy. Więcej informacji znajdziesz w artykule o tworzeniu pierwszego serwera proxy interfejsu API.
Inne materiały, które mogą Ci się przydać: