4.17.05 – informacje o wersji Edge dla Private Cloud

Wyświetlasz dokumentację Apigee Edge.
Zapoznaj się z dokumentacją Apigee X. info

Od poprzedniej wersji funkcji Edge for Private Cloud pojawiły się te wersje, które są uwzględnione w tej wersji funkcji:

Aby dowiedzieć się, jak sprawdzić, czy konkretna wersja chmury jest uwzględniona w Twojej wersji Edge for Private Cloud, przeczytaj artykuł Informacje o numeracji wersji.

Ogólne informacje o wersji

Ta wersja zawiera kilka ważnych funkcji, które pomagają lepiej kontrolować i zabezpieczać interfejsy API, w tym:

• Współdzielone przepływy obsługują wdrażanie bez przestojów.
• Usuwanie danych o zarabianiu w przypadku organizacji jest teraz obsługiwane.
• Dodatkowe nowe funkcje opisane poniżej.

Wycofaliśmy skarbce.

W dalszej części tego artykułu znajdziesz szczegółowe informacje o wszystkich nowych funkcjach, aktualizacjach i poprawkach błędów zawartych w tej wersji.

Wycofania i zakończenia

W tej wersji wycofaliśmy lub usunęliśmy te funkcje: Więcej informacji znajdziesz w zasadach wycofywania funkcji Edge.

Wycofano: dodawanie ścieżek na karcie Skuteczność w przypadku serwera proxy interfejsu API

Do tej wersji można było przejść do serwera proxy interfejsu API w interfejsie zarządzania, otworzyć kartę Skuteczność i utworzyć różne ścieżki do porównania na podstawie wykresu na karcie Skuteczność serwera proxy oraz w panelu Transakcje biznesowe. Ta funkcja została wycofana i nie jest już dostępna w interfejsie. Alternatywę dla tej funkcji znajdziesz w tym artykule na forum społeczności Apigee: Alternative to Business Transactions API (Alternatywa dla interfejsu Business Transactions API). (EDGEUI-902)

Wycofany: adres URL buildInfo portalu Usługi dla programistów

W poprzednich wersjach portalu, aby sprawdzić jego wersję, otwórz w przeglądarce ten adres URL:

http://yourportal.com/buildInfo

W wersji 4.17.05 ten link został usunięty. Aby określić wersję, otwórz w Drupalu pozycję menu Raporty > Raport o stanie. Wersja portalu pojawi się w tabeli w wierszu o nazwie Profil instalacji.

Wycofanie bezpiecznego magazynu Apigee (skarbca)

Bezpieczny magazyn Apigee, zwany też „skrytkami”, zostanie wycofany z użycia i zamknięty w ciągu roku od daty ogłoszenia wycofania, która jest podana na stronie wycofań i zamknięć. Skrytki, które zapewniają zaszyfrowane przechowywanie par klucz-wartość, są tworzone za pomocą interfejsu API do zarządzania i dostępne w czasie działania za pomocą funkcji w module Node.js apigee-access.

Zamiast bezpiecznego magazynu używaj zaszyfrowanych map wartości klucza (KVM), zgodnie z opisem w artykule Praca z mapami wartości klucza. Szyfrowane klucze KVM są tak samo bezpieczne jak skarbce i zapewniają więcej opcji tworzenia i pobierania. (MGMT-3848)

Nowe funkcje i aktualizacje

Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji. Oprócz poniższych ulepszeń ta wersja zawiera też wiele ulepszeń dotyczących użyteczności, wydajności, bezpieczeństwa i stabilności.

Chmura prywatna

Dodano do instalacji nowy wymagany parametr konfiguracji SMTP

Teraz musisz użyć parametru SMTPMAILFROM w pliku konfiguracji instalacji Edge. Ten parametr określa adres e-mail używany, gdy Edge wysyła automatyczne e-maile, np. gdy użytkownik prosi o zresetowanie hasła. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

(EDGEUI-1020)

Możesz teraz ustawić limit czasu używany przez interfejs Edge do wywołań interfejsu Edge API związanych z zarządzaniem.

Możesz teraz określić czas oczekiwania interfejsu API używany przez interfejs Edge, aby kontrolować, jak długo interfejs czeka na zwrócenie wywołania zarządzania interfejsem API. Limit czasu określają te właściwości:

• Parametr conf_apigee_apigee.feature.apitimeout określa czas (w sekundach), przez jaki interfejs czeka na odpowiedź z backendu, niezależnie od aktywności w tym czasie. Jeśli wywołanie nie zostanie zakończone w tym czasie, interfejs wyświetli błąd przekroczenia czasu oczekiwania. Wartością domyślną jest 180 sekund (3 minuty).
• conf_apigee_play.ws.timeout.idle określa, jak długo interfejs czeka na aktywność na serwerze (w milisekundach). Może mieć taką samą wartość jak conf_apigee_apigee_apitimeout lub mniejszą. Ustawienie większej wartości nie ma żadnego efektu. Domyślna wartość to 180 000 milisekund (3 minuty).
• conf_apigee_play.ws.timeout.connection określa, jak długo interfejs czeka na nawiązanie połączenia. Może mieć taką samą wartość jak conf_apigee_apigee_apitimeout lub mniejszą. Ustawienie większej wartości nie ma żadnego efektu. Domyślna wartość to 120 000 milisekund (2 minuty).

Więcej informacji znajdziesz w artykule Ustawianie limitu czasu używanego przez interfejs Edge do wywołań interfejsu API zarządzania Edge.

(EDGEUI-816)

Dodano limit czasu ponawiania próby przez procesor wiadomości w routerach

Dodano limit czasu, aby routery przestały ponawiać żądanie do procesorów wiadomości i zwracały komunikat o błędzie.

Więcej informacji znajdziesz w artykule Konfigurowanie routera do ponawiania połączeń z procesorem wiadomości.

(APIRT-2912)

Dodano procedurę zmiany domyślnego administratora systemu

Dodaliśmy dokumentację dotyczącą zmiany domyślnego administratora systemu.

Więcej informacji znajdziesz w artykule Zarządzanie użytkownikami, rolami i uprawnieniami.

(DOS-4895)

Dodano dokumentację dotyczącą rozdzielania zadań instalacji Edge między użytkownika root i użytkownika bez uprawnień roota

Nowa dokumentacja opisuje czynności, które należy wykonać, aby rozdzielić zadania instalacji Edge między użytkownika root i użytkownika bez uprawnień roota.

Więcej informacji znajdziesz w artykule Omówienie instalacji Edge.

(DOS-4573)

Dodaliśmy właściwość umożliwiającą ustawienie nazwy hosta linków w wygenerowanych e-mailach.

Edge automatycznie wysyła e-maile w odpowiedzi na określone zdarzenia, np. gdy użytkownik zostanie dodany do organizacji. Wiele z tych e-maili zawiera link. Na przykład gdy do organizacji zostanie dodany nowy użytkownik, interfejs Edge wyśle mu e-maila z adresem URL logowania w formacie:

https://domain/login

Domena jest określana automatycznie przez Edge i zwykle jest prawidłowa dla organizacji. Jeśli jednak interfejs Edge UI znajduje się za modułem równoważenia obciążenia, automatycznie wygenerowana nazwa domeny może być nieprawidłowa. W takim przypadku możesz użyć właściwości conf_apigee_apigee.emails.hosturl, aby jednoznacznie ustawić część wygenerowanego adresu URL zawierającą nazwę domeny.

Więcej informacji znajdziesz w artykule Ustawianie nazwy hosta dla linków w wygenerowanych e-mailach.

(EDGEUI-1044)

Ustawianie podstawowego adresu URL wyświetlanego przez interfejs Edge dla serwera proxy interfejsu API

Interfejs Edge wyświetla adres URL serwera proxy interfejsu API na podstawie ustawień wirtualnego hosta, w którym jest wdrożony serwer proxy. Może on zawierać numer portu routera hosta wirtualnego.

W większości przypadków adres URL wyświetlany w interfejsie Edge jest prawidłowym adresem URL do wysyłania zewnętrznych żądań do serwera proxy. W przypadku niektórych konfiguracji wyświetlany adres URL jest jednak nieprawidłowy. Na przykład każda z tych konfiguracji może spowodować, że wyświetlany adres URL nie będzie odpowiadać rzeczywistemu adresowi URL używanemu do wysyłania żądań zewnętrznych do serwera proxy:

• Zakończenie SSL następuje w systemie równoważenia obciążenia
• Mapowanie portów odbywa się między systemem równoważenia obciążenia a routerami Apigee.
• System równoważenia obciążenia skonfigurowany z przepisywaniem ścieżek

Edge for Private Cloud w wersji 4.17.05 i nowszych obsługuje atrybut wirtualnego hosta o nazwie <BaseUrl>, który umożliwia zastąpienie adresu URL wyświetlanego przez interfejs Edge. Oto przykład obiektu hosta wirtualnego z nowym atrybutem <BaseURL>. W tym przykładzie w interfejsie Edge wyświetla się wartość „http://myCo.com”:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Jeśli element <BaseUrl> nie jest skonfigurowany (domyślnie), domyślny adres URL renderowany przez interfejs Edge będzie wyglądać tak: „http://DNS_name_or_IP:9005/”, natomiast rzeczywista konfiguracja aliasu hosta to „http://myCo.com”.

Możesz też ustawić podstawowy adres URL podczas tworzenia organizacji za pomocą właściwości VHOST_BASEURL w narzędziu apigee-provision.

Więcej informacji znajdziesz w artykule Konfigurowanie dostępu TLS do interfejsu API w chmurze prywatnej.

(EDGEUI-5008)

Dodaliśmy dokumentację dotyczącą włączania logowania debugowania

Dodaliśmy dokumentację opisującą, jak włączać i wyłączać logowanie debugowania w komponentach Edge.

Więcej informacji znajdziesz w artykule Włączanie rejestrowania debugowania.

(APIRT-4018)

Nowy instalator i składnia poleceń narzędzia apigee-analytics-collector

Wszyscy klienci Edge for Private Cloud muszą przesyłać do Apigee statystyki dotyczące ruchu proxy interfejsu API za pomocą wersji beta narzędzia wiersza poleceń apigee-analytics-collector. To narzędzie odsyła raport o liczbie wywołań interfejsu API do Apigee.

Ta wersja Edge zawiera nowe instrukcje instalacji i składnię poleceń narzędzia apigee-analytics-collector. W tej wersji do instalowania narzędzia apigee-analytics-collector używasz apigee-service zamiast npm. Narzędzie apigee-analytics-collector wywołujesz za pomocą apigee-service zamiast jako samodzielne polecenie.

Więcej informacji znajdziesz w artykule Przesyłanie danych o ruchu interfejsu API do Apigee – wersja beta.

Nowy domyślny katalog instalacyjny po aktualizacji portalu Developer Services Nginx/Postgres z nowej instalacji w wersji 4.17.01

Po zaktualizowaniu nowej instalacji wersji 4.17.01, która korzysta z Nginx/Postgres, katalog główny zmienił się z:

/opt/apigee/apigee-drupal

do:

/opt/apigee/apigee-drupal/wwwroot

Usługi API

Bardziej rygorystyczna weryfikacja danych wejściowych w przypadku podmiotów

W przypadku wszystkich encji organizacji Apigee Edge wprowadziliśmy bardziej rygorystyczną weryfikację danych wejściowych. Dozwolone znaki to zwykle litery (wszystkie przypadki), cyfry i podkreślenie.

Dotyczy to m.in.:

• Organizacje
• Środowiska
• Proxy interfejsów API
• Wersje proxy interfejsu API
• Nazwy zasad w proxy interfejsu API
• Identyfikatory konfiguracji maski śledzenia debugowania
• Nazwy zasobów (wywołanie Java, xsl, wszystkie zasoby)
• Magazyny kluczy
• CRLstores
• Odwołania do zasobów
• Serwery docelowe

(MGMT-3840)

Wdrożenie przepływów współdzielonych bez przestoju

Jeśli chcesz wdrożyć współdzielone przepływy i mieć pewność, że podczas wdrażania odrzucany jest niewielki lub żaden ruch przychodzący, możesz teraz użyć interfejsu API do zarządzania wdrażaniem bez przestojów. Proces jest prawie identyczny jak wdrażanie bez przestoju w przypadku serwerów proxy interfejsu API za pomocą interfejsu Management API. Jedyną różnicą jest zasób interfejsu API do zarządzania.

Poniższe wywołanie wdraża wersję przepływu współdzielonego wskazaną w identyfikatorze URI, a następnie wycofuje wdrożenie poprzedniej wersji (umożliwia to parametr zapytania override=true):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

Zarabianie

Usuwanie danych o zarabianiu w przypadku organizacji

Dane dotyczące zarabiania w Twojej organizacji możesz usunąć w tych sytuacjach:

• Usuń organizację. W takim przypadku musisz usunąć dane dotyczące zarabiania, zanim będzie można usunąć organizację.
• Wyczyść dane o zarabianiu z organizacji testowej, których chcesz użyć ponownie. W tym przypadku po usunięciu danych o zarabianiu musisz zsynchronizować dane Apigee Edge.

Więcej informacji znajdziesz w artykule Usuwanie danych o zarabianiu z organizacji. (DEVRT-2581)

Dodano interfejs API do włączania zarabiania w organizacji

Możesz teraz użyć interfejsu API, aby włączyć zarabianie w organizacji.

Więcej informacji znajdziesz w artykule Włączanie zarabiania w organizacji.

(DEVRT-2383)

Usunięte błędy

W tej wersji naprawiliśmy te błędy: Ta lista jest przeznaczona głównie dla użytkowników, którzy chcą sprawdzić, czy ich zgłoszenia zostały rozwiązane. Nie jest on przeznaczony do dostarczania szczegółowych informacji wszystkim użytkownikom.

Chmura prywatna 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

Cloud 17.03.13.02 (zarabianie)

Cloud 17.03.13.01 (zarabianie)

Cloud 17.03.13 (API Management)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (API runtime)

Cloud 17.02.13 (zarządzanie interfejsami API)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (zarządzanie interfejsami API)

Cloud 17.01.16 (zarabianie)