4.16.05 – informacje o wersji Edge dla Private Cloud

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

31 maja 2016 r. (wtorek) udostępniliśmy nową wersję Apigee Edge for Private Cloud.

Od poprzedniej wersji funkcji Edge dla chmury prywatnej (4.16.01) 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.

Nowe funkcje i ulepszenia

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.

Więcej informacji i instrukcji znajdziesz w dokumentacji Edge for Private Cloud.

Instrukcje instalacji i obsługi przeniesione do internetu

Przewodnik po instalacji i obsłudze Edge for Private Cloud jest teraz dostępny w wersji 4.18.01.

Aktualizacje oprogramowania

Ta wersja zawiera te aktualizacje oprogramowania:

  • Java JDK 1.8 – aby korzystać z najnowszych funkcji Javy, ta wersja jest zgodna z Java 1.8. W środowisku musi być zainstalowany Oracle JDK 1.8 lub OpenJDK 8.
    W ramach aktualizacji do Javy 8 niektóre szyfry TLS nie są już dostępne w Oracle JDK 1.8. Pełną listę znajdziesz w sekcji „Default Disabled Cipher Suites” (Domyślnie wyłączone zestawy szyfrów) na stronie http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13 – zaktualizowana z Cassandra 2.0.15.

Instalacja, uaktualnianie, wycofywanie

Poniżej znajdziesz listę zmian w skryptach instalacyjnych, skryptach uaktualniania i skryptach powiązanych. Informacje o używaniu znajdziesz w dokumentacji Edge for Private Cloud.

  • Nowy proces aktualizacji z wersji 4.16.01 – ta wersja zastępuje narzędzie apigee-migrate narzędziem update.sh, aby zaktualizować instalację z wersji 4.16.01 do 4.16.05. Zobacz Aktualizowanie Apigee Edge 4.16.01 do wersji 4.16.05.
  • Bootstrap
    • bootstrap.sh (wersja 4.16.01) jest teraz bootstrap_4.16.05.sh w wersji 4.16.05.
    • Nie musisz już podawać uname:pword, aby pobrać bootstrap_4.16.05.sh.
  • Cofanie – aby cofnąć aktualizację do wersji 4.16.05, odinstaluj komponent w wersji 4.16.05 i zainstaluj ponownie poprzednią wersję. Poprzednie narzędzie rollback.sh zostało usunięte. Zobacz 4.16.05 Proces wycofywania.
  • setup.sh i update.sh mogą zapisywać plik dziennika w /tmp – domyślnie narzędzia setup.sh i update.sh zapisują informacje w dzienniku w /opt/apigee/var/log/apigee-setup. Jeśli użytkownik uruchamiający narzędzie nie ma dostępu do tego katalogu, zapisuje dziennik w katalogu /tmp. Jeśli użytkownik nie ma dostępu do /tmp, narzędzie nie działa.
  • Procedura aktualizacji interfejsu API BaaS – w wersji 4.16.01 interfejs API BaaS trzeba było ponownie zainstalować, aby go przenieść. Nowe narzędzie update.sh umożliwia aktualizowanie interfejsu API BaaS w miejscu. Zobacz Aktualizowanie Apigee Edge 4.16.01 do wersji 4.16.05.

Administracja

Poniżej znajdziesz nowe funkcje administracji i konfiguracji chmury prywatnej.

  • Weryfikacja instalacji – narzędzie apigee-validate używane do testowania instalacji Edge Private Cloud można teraz uruchamiać z serwera zarządzania. Wcześniej skrypt musiał być uruchamiany na procesorze komunikatów. Zobacz Testowanie instalacji.
  • Nazwa regionu – region może mieć dowolną nazwę. W poprzednich wersjach nazwa miała postać „dc-#”, gdzie # to liczba całkowita.
  • Bloki reklamowe bramy – bloki reklamowe bramy mogą mieć dowolną nazwę. W poprzednich wersjach pod musi mieć nazwę „gateway”.
  • Administrowanie za pomocą skryptów – nowe narzędzie wiersza poleceń apigee-adminapi.sh umożliwia wykonywanie tych samych zadań konfiguracyjnych Edge, które wykonujesz, wywołując interfejs Edge Management API. Zobacz Korzystanie z narzędzia apigee-adminapi.sh.
  • Cicha konfiguracja SSL hosta wirtualnego – podczas tworzenia organizacji lub środowiska możesz teraz przekazywać właściwości, aby skonfigurować SSL na hoście wirtualnym. Zobacz Wprowadzanie organizacji.

Usługi API

Poniżej znajdziesz nowe funkcje usług API Edge, które zostały udostępnione w poprzednich wersjach produktu w chmurze.

Prefiks o stałej długości do logowania wiadomości syslog (Cloud 16.03.30)

Zasady logowania wiadomości mają nowy element <FormatMessage> w konfiguracji Syslog. Ustawiając <FormatMessage>true</FormatMessage>, możesz sprawić, że wiadomości Syslog będą zaczynać się od stałej liczby znaków, co pozwoli Ci odfiltrować dane wstawione przez Apigee. Więcej informacji znajdziesz w zasadach dotyczących rejestrowania wiadomości. (APIRT-1398)

Symbol wieloznaczny w podstawowej ścieżce proxy interfejsu API (interfejs Cloud 16.03.09)

Interfejs zarządzania obsługuje używanie co najmniej 1 symbolu wieloznacznego /*/ w ścieżkach podstawowych serwera proxy interfejsu API. Na przykład ścieżka podstawowa /team/*/members umożliwia klientom wywoływanie Twojego serwera proxy za pomocą https://[host]/team/blue/members lub https://[host]/team/green/members bez konieczności tworzenia nowego serwera proxy do obsługi nowych zespołów. Pamiętaj, że /**/ jest niedozwolone. (MGMT-3154)

Łączenie proxy interfejsu API (Cloud 16.03.02, interfejs Cloud 16.03.09)

Edge obsługuje lokalne łączenie proxy interfejsu API, co umożliwia jednemu proxy interfejsu API wywoływanie innego proxy interfejsu API wdrożonego w organizacji Edge bez dodatkowych obciążeń sieciowych. Wcześniej łańcuchowanie proxy interfejsu API wymagało wywołania http(s) innego proxy interfejsu API, które przekazywało żądanie przez moduł równoważenia obciążenia, router i procesor wiadomości.

W elemencie TargetEndpoint serwera proxy interfejsu API dostępne są nowe elementy LocalTargetConnection, które umożliwiają określenie nazwy serwera proxy interfejsu API, nazwy konkretnego elementu ProxyEndpoint w serwerze proxy interfejsu API lub po prostu ścieżki podstawowej do lokalnego zasobu serwera proxy interfejsu API (np. /v1/myresource). Interfejs edytora serwera proxy udostępnia też te opcje, gdy dodajesz lub aktualizujesz element TargetEndpoint.

Łączenie serwerów proxy jest też dostępne w zasadach wywołania usługi.

Więcej informacji znajdziesz w artykule Łączenie ze sobą serwerów proxy interfejsu API. Nowe elementy LocalTargetConnection są też wymienione w schemacie XML: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

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.

Edge for Private Cloud 4.16.05

Identyfikator problemu Opis
PRC-770 Instalator w wersji 16.01 nie rejestruje serwera rezerwowego Postgres w grupie axgroup
PRC-758 Użytkownik z rolą Użytkownik może edytować raporty niestandardowe
PRC-883 Aktualizacja serwera Postgres z konfiguracją główny-rezerwowy nie powiodła się

Cloud 16.03.30

Identyfikator problemu Opis
SECENG-584 Sprawdzanie poprawności znaku nowego wiersza między certyfikatami w łańcuchu certyfikatów powoduje problemy z niektórymi certyfikatami w środowisku produkcyjnym
MGMT-3217 Wywołania interfejsu API zarządzania Google Analytics kończą się niepowodzeniem, jeśli nazwa KVMap kończy się ciągiem „keys”
MGMT-3214 Podczas wywołań JavaCallout mogą wystąpić konflikty klas, które spowodują niepowodzenie kodu Java klienta
MGMT-3185 Błąd podczas dodawania administratorów organizacji do organizacji
EDGEUI-127 Uzyskiwanie niewystarczających uprawnień w nowym edytorze serwera proxy
EDGEUI-119 Problem z limitem czasu sesji w interfejsie
CORESERV-671 Wyświetlają się błędy „No rings configured; Cannot initialize cps service” (Nie skonfigurowano dzwonków; nie można zainicjować usługi cps)
AXAPP-2345 Problem z wyświetlaniem raportów niestandardowych AX w przypadku klientów niekorzystających z usługi CPS
AXAPP-2302 W dziennym podsumowaniu analityki Apigee w sekcji dotyczącej wdrażania przez deweloperów wyświetla się zero
APIRT-2750 Wysoka liczba błędów w ruchu w określonej organizacji
APIRT-2516 Błędy czasu działania w wywołaniach JavaScriptu wskazują nieprawidłowe numery wierszy
APIRT-2508 Błąd wyjścia podczas wywoływania funkcji express listen w wywołaniu zwrotnym w skarbcu
APIRT-2336 Problem z gzip w Node.js
APIRT-1975 Konfiguracje maskowania nie działają w przypadku message.content

Interfejs Cloud 16.03.16

Identyfikator problemu Opis
MGMT-3142 Wykresy nie wczytują się w panelu Analiza błędów (zaktualizowana poprawka)

Interfejs Cloud 16.03.09

Identyfikator problemu Opis
MGMT-3158 Niewystarczające uprawnienia w interfejsie, gdy kontrola dostępu oparta na rolach w przypadku poszczególnych serwerów proxy jest ustawiona za pomocą interfejsu API
MGMT-3142 Wykresy nie wczytują się w panelu Analiza błędów
MGMT-3118 Interfejs wyświetla nieprawidłową konfigurację wirtualnego hosta SSL dla parametru „clientAuthEnabled”
DEVRT-2344 Definicje raportów jednodniowych nie wczytują transakcji w interfejsie

Cloud 16.03.02

Identyfikator problemu Opis
MGMT-3083 Automatyczne odświeżanie logów Node.js jest zbyt szczegółowe w przypadku wiadomości logów
DEVRT-2275 W przypadku planów cenowych z atrybutami niestandardowymi wyświetla się tylko 5 atrybutów zamiast 10 dozwolonych
DEVRT-1275 Nie wszyscy deweloperzy są widoczni w menu Plan stawek
DEVRT-1074 Deweloper korzystający z przedpłaty, który nie ma środków na koncie, otrzymuje wyjątek NullPointerException, gdy zostaną zastosowane środki

Cloud 16.02.17

Identyfikator problemu Opis
MGMT-3083 Automatyczne odświeżanie logów Node.js jest zbyt szczegółowe w przypadku wiadomości logów
MGMT-3077 Interfejs generuje nieprawidłowy pakiet serwera proxy z pliku WSDL, który używa domyślnej przestrzeni nazw
MGMT-1642 W roli niestandardowej użytkownika brakuje uprawnienia „get” do aplikacji dewelopera

Znane problemy

W tej wersji występują te znane problemy.

Identyfikator problemu Opis
APIRT-2978

Nie udało się uruchomić Nginx na routerze lub nie udało się uruchomić routera

Jeśli router brzegowy nie uruchomi Nginx lub nie uruchomi się wcale, jak pokazano w pliku /opt/apigee/var/log/edge-router/logs/system.log, usuń wszystkie pliki z katalogu /opt/nginx/conf.d i ponownie uruchom router:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

Procesor komunikatów wykonuje wyszukiwanie DNS w przypadku adresów IPv4 i IPv6

Jeśli masz zainstalowany i włączony NSCD (Name Service Cache Daemon), możesz zauważyć, że procesory wiadomości wykonują 2 wyszukiwania DNS: jedno dla IPv4 i jedno dla IPv6.

Aby wyłączyć wyszukiwanie DNS w przypadku IPv6:

  1. Na każdym węźle procesora komunikatów edytuj plik /etc/nscd.conf.
  2. Ustaw tę właściwość:

    enable-cache hosts no
PRC-1118

Błąd podczas uruchamiania polecenia „apigee-service apigee-postgresql pg-data-purge”

Jeśli po uruchomieniu polecenia „apigee-service apigee-postgresql pg-data-purge” pojawi się błąd w formie:

BŁĄD: musisz być właścicielem relacji

Edytuj plik /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge i ustaw w nim tę właściwość na „apigee”:

POSTGRES_USER=apigee
DOC-1687 Ze względu na znany konflikt zależności pakietów agent Katello używany w Satellite Server 6 nie zainstaluje się prawidłowo na hostach Apigee Edge z demonem Qpid.

Ładunki JSON w zasadach Assign Message, Java Callout i Raise Fault

Zasady Assign Message, Java Callout i Raise Fault umożliwiają generowanie treści wiadomości za pomocą elementu <Set><Payload>. W ramach tych wiadomości możesz uwzględniać zmienne, których wartości są automatycznie wypełniane w czasie działania programu. Jeśli na przykład chcesz wyświetlić datę z nagłówka HTTP, możesz wstawić do wiadomości wartość {message.header.date}.

Jeśli format wiadomości to JSON, będzie ona wyglądać mniej więcej tak:

{"The date is: " : "{message.header.date}"}

Widać jednak, że jest to nieprawidłowy kod JSON. Aby obejść ten problem, masz 2 opcje:

  • Zmień znaczenie otwierającego nawiasu klamrowego za pomocą ukośnika lewego: 
    \{"The date is: " : "{message.header.date}"}
  • W konfiguracji elementu Ładunek użyj atrybutów variablePrefix i variableSuffix, aby wskazać zmienną w ładunku JSON. Na przykład:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

W kolejnej wersji funkcji Edge for Private Cloud będzie można bez problemu używać nawiasów klamrowych w przypadku zmiennych w wiadomościach JSON. (APIRT-1160)

Router nie uruchamia Nginx lub Router nie uruchamia się

Jeśli router brzegowy nie uruchomi Nginx lub nie uruchomi się wcale, jak pokazano w pliku /opt/apigee/var/log/edge-router/logs/system.log, usuń wszystkie pliki w katalogu /opt/nginx/conf.d i ponownie uruchom router:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Wstecz
4.16.05.01
Dalej
16.04.08