4.17.05 – informacje o wersji Edge dla Private Cloud

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Od poprzedniej wersji funkcji Edge dla chmury prywatnej miały miejsce 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:

• Przepływy współdzielone 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.

Wycofane: dodawanie ścieżek na karcie Skuteczność 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)

Wycofano: adres URL buildInfo w portalu usług 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 (skarbce)

Bezpieczny magazyn Apigee, zwany też „skrytkami”, jest wycofywany i zostanie zamknięty rok po dacie 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 Management API i dostępne w czasie działania za pomocą funkcji w module Node.js apigee-access.

Zamiast bezpiecznego magazynu używaj zaszyfrowanych map klucz-wartość (KVM), jak opisano w artykule Korzystanie z map klucz-wartość. Szyfrowane klucze KVM są tak samo bezpieczne jak skarbce i zapewniają więcej opcji tworzenia i pobierania. (MGMT-3848)

Nowe funkcje i aktualizacje

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

Chmura prywatna

Dodano nowy wymagany parametr konfiguracji SMTP do instalacji

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 w węźle.

(EDGEUI-1020)

Możesz teraz ustawić limit czasu używany przez interfejs Edge UI w przypadku wywołań interfejsu Edge API do zarządzania.

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 ukończone w tym czasie, interfejs zgłosi 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 wpływu. 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 wpływu. 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 Edge API.

(EDGEUI-816)

Dodano limit czasu ponawiania działania procesora komunikatów 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 komunikatów.

(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 tym artykule.

(DOS-4573)

Dodano właściwość umożliwiającą ustawienie nazwy hosta dla linków w generowanych e-mailach

Edge automatycznie wysyła e-maile w odpowiedzi na określone zdarzenia, np. gdy użytkownik zostanie dodany do organizacji. Wiele z nich 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 w przypadku 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. Jeśli tak jest, możesz użyć właściwości conf_apigee_apigee.emails.hosturl, aby jednoznacznie ustawić część wygenerowanego adresu URL, która zawiera 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 proxy interfejsu API na podstawie ustawień wirtualnego hosta, w którym jest wdrożony proxy. Może ona 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żki

Edge for Private Cloud w wersji 4.17.05 i nowszych obsługuje atrybut hosta wirtualnego 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 wysyła raport o liczbie wywołań interfejsu API z powrotem 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 zamiast npm używasz apigee-service, a do wywoływania narzędzia apigee-analytics-collector zamiast polecenia autonomicznego używasz apigee-service.

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 wprowadzono 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 serwerze 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)

Wdrażanie przepływów współdzielonych bez przestoju

Jeśli chcesz wdrożyć współdzielone przepływy i mieć pewność, że podczas wdrażania odrzucana jest niewielka ilość ruchu przychodzącego lub nie jest odrzucana wcale, możesz teraz użyć interfejsu API do zarządzania wdrażaniem bez przestojów. Proces jest niemal identyczny jak wdrażanie bez przestoju w przypadku serwerów proxy interfejsu API za pomocą interfejsu Management API. Jedyna różnica to zasób interfejsu API do zarządzania.

Poniższe wywołanie wdraża wersję współdzielonego przepływu wskazaną w identyfikatorze URI, a następnie wycofuje wdrożoną wcześniej wersję (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 organizacji możesz usunąć w tych sytuacjach:

• Usuń organizację. W takim przypadku musisz usunąć dane o zarabianiu, zanim usuniesz organizację.
• Wyczyść dane dotyczące zarabiania w organizacji testowej, której chcesz ponownie użyć. 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 przypadku organizacji

Możesz teraz używać interfejsu API do włączania zarabiania w organizacji.

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

(DEVRT-2383)

Poprawione 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 (zarządzanie interfejsami API)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (środowisko wykonawcze interfejsu API)

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)