Informacje o wersji Edge Microgateway

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

Wersja 3.3.x

Poprawki błędów i ulepszenia w wersji 3.3.x

3.3.7

17 lipca 2025 roku wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Poprawki błędów i ulepszenia:

edgemicro:
  plugins:
    excludeUrls: '/hello,/proxy_one/*' # global exclude urls
    sequence:
      -oauth
      -json2xml
      -quota
      -json2xml:
          excludeUrls: '/hello/xml/*'  # plugin level exclude urls

Rozwiązane problemy dotyczące bezpieczeństwa

• CVE-2024-12905
• CVE-2025-46653

3.3.6

16 kwietnia 2025 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.6. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Rozwiązane problemy dotyczące bezpieczeństwa

• CVE-2025-27789
• CVE-2024-21538
• CVE-2024-12133

3.3.5

W piątek 20 grudnia 2024 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.5. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

current nodejs version is  18.x.x Note, v18.x.x will be out of support soon, see https://docs.apigee.com/release/notes/edge-microgateway-release-notes-0

You are using a version of NodeJS that is not supported

Rozwiązane problemy dotyczące bezpieczeństwa

• CVE-2024-21538
• CVE-2024-45590
• CVE-2019-3844
• CVE-2019-12290
• CVE-2020-1751
• CVE-2018-12886
• CVE-2023-50387
• CVE-2019-3843
• CVE-2022-4415
• CVE-2021-3997

3.3.4

18 września 2024 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.4. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy dotyczące bezpieczeństwa

• CVE-2021-23337
• CVE-2024-4068
• CVE-2020-28469
• CVE-2020-28503

3.3.3

25 kwietnia 2024 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.3. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy dotyczące bezpieczeństwa

• CVE-2023-0842
• CVE-2023-26115
• CVE-2022-25883
• CVE-2017-20162
• CVE-2022-31129
• CVE-2022-23539
• CVE-2022-23541
• CVE-2022-23540
• CVE-2024-21484
• CVE-2022-46175
• CVE-2023-45133
• CVE-2020-15366
• CVE-2023-26136
• CVE-2023-26115

3.3.2

18 sierpnia 2023 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.2. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy dotyczące bezpieczeństwa

Brak.

3.3.1

7 czerwca 2022 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.1. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy dotyczące bezpieczeństwa

3.3.0

4 lutego 2022 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.3.0. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

npm install apigeetool@0.15.1

Wersja 3.2.x

Poprawki błędów i ulepszenia w wersji 3.2.x

3.2.3

17 września 2021 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.2.3. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy dotyczące bezpieczeństwa

3.2.2

W czwartek 15 lipca 2021 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.2.2. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

Rozwiązane problemy dotyczące bezpieczeństwa

3.2.1

W piątek 5 marca 2021 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.2.1. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

edgemicro:
 enable_GET_req_body: true

3.2.0

W czwartek 21 stycznia 2021 roku wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.2.0. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

Wersja 3.1.x

Poprawki błędów i ulepszenia w wersji 3.1.x

3.1.8

W poniedziałek 16 listopada 2020 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.8. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

3.1.7

W czwartek 24 września 2020 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.7. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

{"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}

3.1.6

W czwartek 20 sierpnia 2020 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.6. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

3.1.5

W piątek 26 czerwca 2020 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.5. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

3.1.4

W piątek 23 kwietnia 2020 r. wprowadziliśmy w Edge Microgateway następującą poprawkę.

Poprawka błędu:

Naprawiliśmy problem z zależnościami w wersji 3.1.3. Wersja 3.1.3 została oznaczona jako przestarzała w repozytorium npm. W przeciwnym razie wszystkie poprawki błędów i ulepszenia opisane w informacjach o wersji 3.1.3 będą dotyczyć tej wersji.

3.1.3

W środę 15 kwietnia 2020 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.3. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 153509313. Rozwiązaliśmy problem, który powodował wycieki pamięci w module debugowania Node.js. Problem występuje w wersjach 3.1.0, 3.1.1 i 3.1.2.
• 153509313 – rozwiązaliśmy problem, który powodował, że w danych wyjściowych rejestrowania był drukowany ten sam identyfikator wiadomości dla 2 różnych transakcji.
• 151673570 – rozwiązano problem polegający na tym, że Edge Microgateway nie był aktualizowany w celu korzystania z nowych interfejsów Apigee KVM API. Edge Microgateway używa teraz nowych poleceń do dodawania i aktualizowania wartości KVM.
• 152822846 – w poprzednich wersjach Edge Microgateway został zaktualizowany, aby jego przetwarzanie mapowania ścieżki zasobu było zgodne z Apigee Edge. W tej wersji rozwiązaliśmy problem polegający na nieprawidłowej obsłudze wzorca /literal_string/*. Na przykład: /*/2/*. Zobacz też Konfigurowanie działania ścieżki zasobu „/”, „/*” i „/**”.
• 152005003 - Changes were made to enable organization and environment scoped identifiers for quotas.
• 152005003 - Changes were made to enable organization and environment scoped identifiers for quotas. Kombinacja „org + env + appName + productName” jest używana jako identyfikator limitu.

3.1.2

W poniedziałek 16 marca 2020 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.3. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 151285018 – wprowadziliśmy ulepszenie funkcji, aby dodać obsługę serwera proxy HTTP dla ruchu między Edge Microgateway a docelowymi backendami. Dodatkowo rozwiązano problemy z dotychczasową obsługą serwera proxy HTTP między Edge Microgateway a Apigee Edge. Więcej informacji:
  • Używanie serwera proxy HTTP do komunikacji z Apigee Edge
  • Używanie serwera proxy HTTP do komunikacji z miejscem docelowym
• 149101890 – kod powiadomienia w dzienniku w przypadku, gdy serwer docelowy lub moduł równoważenia obciążenia zamyka połączenie, został zmieniony z ERROR na INFO.
• 150746985 – rozwiązaliśmy problem, który powodował, że polecenie edgemicro verify nie działało prawidłowo, jeśli w pliku konfiguracyjnym występowały znaki redisBasedConfigCache: true lub quotaUri: https://%s-%s.apigee.net/edgemicro-auth.
• 151284716 – wprowadzono ulepszenie, które umożliwia szybsze zamykanie połączeń z serwerem, gdy pracownicy są ponownie uruchamiani podczas ponownego wczytywania.
• 151588764. Zaktualizuj wersję Node.js w obrazie Dockera używanym do uruchamiania Edge Microgateway w kontenerze Dockera do wersji 12, ponieważ wersja 8 Node.js jest wycofana.
• 151306049 – zaktualizowano dokumentację, aby uwzględnić interfejsy API zarządzania Apigee Edge, które są używane przez polecenia interfejsu Edge Microgateway CLI. Zobacz Z jakich interfejsów API do zarządzania korzysta Edge Microgateway?.

3.1.1

W czwartek 20 lutego wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.1. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 146069701. Rozwiązaliśmy problem polegający na tym, że moduł microgateway-core nie uwzględniał zmiennych środowiskowych HTTP_PROXY i HTTPS_PROXY. Po wprowadzeniu tej zmiany ustawienia serwera proxy w pliku konfiguracyjnym YAML, jeśli zostały określone, są teraz ignorowane. Do określania serwera proxy używane są tylko zmienne środowiskowe.

  Jeśli chcesz określić konfigurację serwera proxy w pliku konfiguracyjnym, musisz też podać zmienną HTTP_PROXY, która zawiera ten sam adres URL serwera proxy co ten podany w pliku konfiguracyjnym. Jeśli na przykład określisz taką konfigurację:

  edge_config:
    proxy: http://10.128.0.20:3128
    proxy_tunnel: true

  Musisz też określić tę zmienną środowiskową:

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620. Dodano nowy parametr konfiguracji: edgemicro.headers_timeout. Ten atrybut ogranicza czas (w milisekundach), przez jaki parser HTTP będzie czekać na otrzymanie pełnych nagłówków HTTP. Na przykład:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  Wewnętrznie parametr ustawia atrybut Node.js Server.headersTimeout w żądaniach. (Domyślnie: 5 sekund więcej niż czas ustawiony za pomocą edgemicro.keep_alive_timeout. To ustawienie domyślne zapobiega przypadkowemu przerwaniu połączenia przez systemy równoważenia obciążenia lub serwery proxy).

• 149278885 – dodaliśmy nową funkcję, która umożliwia ustawienie limitu czasu docelowego interfejsu API na poziomie serwera proxy interfejsu API zamiast używania jednego globalnego ustawienia limitu czasu.

  Jeśli w proxy interfejsu API ustawisz właściwość TargetEndpoint io.timeout.millis, Edge Microgateway będzie mógł pobrać tę właściwość i zastosować limity czasu specyficzne dla docelowego punktu końcowego. Jeśli ten parametr nie zostanie zastosowany, Edge Microgateway użyje globalnego limitu czasu określonego za pomocą edgemicro.request_timeout.

3.1.0

We wtorek 21 stycznia wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W poniższej tabeli znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.1.0. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 144187500 - A new WARN level event will be logged when the quotas.failOpen flag is triggered. Ten sygnał jest wywoływany, gdy wystąpi błąd przetwarzania limitu lub gdy żądanie „quota apply” (zastosuj limit) do Edge nie zaktualizuje zdalnych liczników limitów. W takim przypadku limit będzie przetwarzany tylko na podstawie lokalnych wartości do czasu następnej pomyślnej synchronizacji zdalnego limitu. Wcześniej to zdarzenie było rejestrowane tylko wtedy, gdy poziom dziennika był ustawiony na DEBUG.

  Na przykład:

  2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
  [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
  available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
  [GET][][][][]

• 145023519 – rozwiązaliśmy problem polegający na tym, że w przypadku wykrycia przez Edge Microgateway zmiany w proxy interfejsu API miało to wpływ na transakcje w toku lub nowe. Gdy wprowadzisz zmianę w serwerze proxy, Edge Microgateway odświeży pamięć podręczną, a węzły robocze zostaną ponownie uruchomione. Ta zmiana nie ma wpływu na transakcje w toku ani na nowe wywołania interfejsu API wysyłane do mikrobramy.
• 146378327. Poziom rejestrowania w przypadku sourceRequest, targetRequest i targetResponse został zmieniony na poziom INFORMACJE.
• 146019878 – usunięto rozbieżność między czasem oczekiwania obliczonym dla „Wydajności serwera proxy API” w statystykach Edge a zdarzeniami dziennika sourceResponse/targetResponse Edge Microgateway. Opóźnienie w przypadku zdarzeń z dziennika Edge Analytics i Microgateway jest teraz takie samo.
• Zmiany w logice dopasowywania wzorców:
  • 147027862 – wtyczka OAuth została zaktualizowana, aby obsługiwać te wzorce dopasowywania ścieżek zasobów określone w produktach API:
    • /{literal}**
    • /{literal}*
    • Dowolna kombinacja powyższych 2 wzorców

    Dzięki tej zmianie wtyczka Edge Microgateway stosuje teraz to samo dopasowywanie wzorców co Apigee Edge, co zostało wyjaśnione w artykule Konfigurowanie działania ścieżki zasobu „/”, „/*” i „/**”.

  • 145644205. Zaktualizuj logikę dopasowywania wzorców w przypadku wtyczki apiKeys, aby była zgodna z wtyczką oauth.
• 143488312 – rozwiązano problem, w którym spacje na początku lub na końcu parametru identyfikatora klienta powodowały, że lista produktów JWT była pusta w przypadku żądań tokena OAuth i klucza API.
• 145640807 i 147579179 – dodaliśmy nową funkcję, która umożliwia specjalnej instancji Edge Microgateway o nazwie „synchronizator” pobieranie danych konfiguracyjnych z Apigee Edge i zapisywanie ich w lokalnej bazie danych Redis. Inne instancje mikrobramy można następnie skonfigurować tak, aby odczytywały dane konfiguracyjne z bazy danych. Ta funkcja zwiększa odporność Edge Microgateway. Umożliwia to uruchamianie i działanie instancji mikrobramy bez konieczności komunikowania się z Apigee Edge. Więcej informacji znajdziesz w artykule Korzystanie z synchronizatora.

  Funkcja synchronizatora jest obecnie obsługiwana w przypadku Redis w wersji 5.0.x.

Wersja 3.0.x

Poprawki błędów i ulepszenia w wersji 3.0.x

3.0.10

W piątek 8 listopada wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.0.10. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 142677575 – wprowadziliśmy aktualizację funkcji, dzięki której dopasowywanie wzorców ścieżek zasobów używanych w produktach API dla Edge Microgateway jest teraz zgodne z dopasowywaniem wzorców ścieżek zasobów używanym przez Apigee Edge, zgodnie z opisem w artykule Konfigurowanie działania ścieżki zasobu „/”, „/*” i „/**”.

  Uwaga: jeśli używasz złożonego wzorca zasobów, np. /*/2/**, musisz się upewnić, że serwer proxy edgemicro_auth jest dodany do samodzielnej usługi API. Następnie musisz dodać ten produkt do aplikacji dewelopera serwera proxy, jak pokazano na tym zrzucie ekranu:

  

  Uwaga: właściwość konfiguracji features.isSingleForwardSlashBlockingEnabled opisana w artykule Konfigurowanie działania ścieżki zasobu „/”, „/*” i „/**” nie jest obsługiwana w przypadku Edge Microgateway.

• 143740696 – zmieniła się struktura konfiguracji quotas (patrz też informacje o wersji 3.0.9). Właściwość quotas służy do konfigurowania wtyczki limitu. Zmiana struktury została wprowadzona, aby zwiększyć przejrzystość elementów konfiguracji. Aby skonfigurować wtyczkę limitu, użyj tej konfiguracji YAML. Pamiętaj, że właściwość konfiguracji ma nazwę quotas. Szczegółowe informacje o poszczególnych właściwościach konfiguracji quotas znajdziesz w artykule Opcje konfiguracji limitu.

  edgemicro:
    home: ../gateway
    port: 8000
    max_connections: -1
    max_connections_hard: -1
    logging:
      level: info
      dir: /var/tmp
      stats_log_interval: 60
    plugins:
      dir: ../plugins
      sequence:
        - oauth
        - quota
  quotas:
    bufferSize:
      hour: 20000
      minute: 500
      default: 10000
    useDebugMpId: true
    failOpen: true
  ...

• 141750056. Dodaliśmy nową funkcję, która umożliwia używanie Redis jako pamięci zapasowej limitu. Jeśli useRedis ma wartość true, używany jest moduł volos-quota-redis. Jeśli wartość to „true”, limit jest ograniczony tylko do tych instancji Edge Microgateway, które łączą się z Redis. Jeśli wartość jest fałszywa, jako pamięć zapasowa używany jest moduł volos-quota-apigee, a licznik limitu jest globalny. Więcej informacji znajdziesz w artykule Opcje konfiguracji limitu. Na przykład:

  edgemicro:
  ...
  quotas:
    useRedis: true
    redisHost: localhost
    redisPort: 6379
    redisDb: 1

• 140574210.Domyślny czas wygaśnięcia tokenów generowanych przez serwer proxy edgemicro-auth został zmieniony z 108 000 milisekund (1,8 minuty) na 1800 sekund (30 minut).
• 143551282. Aby obsługiwać organizacje z włączonym protokołem SAML, polecenie edgemicro genkeys zostało zaktualizowane i zawiera teraz parametr ‑‑token. Ten parametr umożliwia użycie tokena OAuth do uwierzytelniania zamiast nazwy użytkownika i hasła. Więcej informacji znajdziesz w artykule Generowanie kluczy.

3.0.9

W piątek 11 października wprowadziliśmy te poprawki i ulepszenia w usłudze Edge Microgateway.

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.0.9. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 141989374 – dodano nową funkcję „fail open” dla wtyczki limitu. Jeśli ta funkcja jest włączona, w przypadku wystąpienia błędu przetwarzania limitu lub niepowodzenia żądania „quota apply” do Edge w zakresie aktualizacji zdalnych liczników limitów limit będzie przetwarzany tylko na podstawie lokalnych wartości, dopóki nie nastąpi kolejna udana synchronizacja zdalnego limitu. W obu tych przypadkach w obiekcie żądania ustawiana jest flaga quota-failed-open.

  Aby włączyć funkcję „fail open” limitu, ustaw tę konfigurację:

  quotas :
   failOpen : true

  Uwaga: dodatkowo nazwa flagi obiektu żądania fail-open wtyczki OAuth została zmieniona na oauth-failed-open.

• 142093764. W celu zapobiegania przekraczaniu limitów wprowadzono zmianę konfiguracji serwera proxy edgemicro-auth. Zmiana polega na ustawieniu typu limitu na kalendarzowy. Aby korzystać z tego ulepszenia, musisz zaktualizować edgemicro-auth do wersji 3.0.7 lub nowszej.
• 142520568 – dodano nową funkcję, która umożliwia rejestrowanie identyfikatora MP (procesora wiadomości) w odpowiedziach dotyczących limitów. Aby korzystać z tej funkcji, musisz zaktualizować edgemicro-auth serwer proxy do wersji 3.0.7 lub nowszej i ustawić tę konfigurację:

  quotas:
    useDebugMpId: true

  Gdy parametr useDebugMpId jest ustawiony, odpowiedzi dotyczące limitu z Edge będą zawierać identyfikator MP i będą rejestrowane przez Edge Microgateway. Na przykład:

  {
      "allowed": 20,
      "used": 3,
      "exceeded": 0,
      "available": 17,
      "expiryTime": 1570748640000,
      "timestamp": 1570748580323,
      "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
  }

3.0.8

W czwartek 26 września wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.0.8. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 140025210. Dodano nową funkcję „fail open”. Ta funkcja umożliwia kontynuowanie przetwarzania interfejsu API, jeśli nie można odświeżyć wygasłego tokena JWT z powodu błędu połączenia, który uniemożliwia wykonanie wywołania weryfikacji klucza interfejsu API do edgemicro-auth proxy.

  Ta funkcja umożliwia ustawienie okresu prolongaty, w którym stary token pozostaje w pamięci podręcznej i jest ponownie używany do momentu wygaśnięcia okresu prolongaty. Ta funkcja umożliwia Edge Microgateway kontynuowanie przetwarzania żądań w przypadku tymczasowej awarii połączenia. Gdy połączenie zostanie przywrócone i zostanie wykonane wywołanie interfejsu API weryfikacji, pobrany zostanie nowy token JWT, który zastąpi stary token JWT w pamięci podręcznej.

  Aby skonfigurować nową funkcję „fail open”:

  1. Ustaw te właściwości w sekcji oauth w pliku konfiguracji Edge Microgateway:

     oauth:
       failOpen: true
       failopenGraceInterval: time_in_seconds
       cacheKey: true
       ...

     Na przykład:

     oauth:
       failOpen: true
       failopenGraceInterval: 5
       cacheKey: true
       ...

     W tym przykładzie stary token będzie używany przez 5 sekund, jeśli nie można go odświeżyć z powodu problemu z połączeniem. Po 5 sekundach zostanie zwrócony błąd uwierzytelniania.

• 141168968 – wprowadzono zmianę, aby we wszystkich danych wyjściowych dziennika wtyczki uwzględniać znak correlation_id. Poza tym w niektórych logach zmieniono poziomy logowania na error.
• 140193349 – wprowadzono aktualizację edgemicro-auth proxy, aby wymagać weryfikacji klucza i klucza tajnego Edge Microgateway przy każdym żądaniu weryfikacji klucza interfejsu API. Edge Microgateway zostało zaktualizowane, aby zawsze wysyłać klucz i klucz tajny w każdym żądaniu weryfikacji klucza interfejsu API. Ta zmiana uniemożliwia klientom uzyskanie tokena JWT tylko za pomocą klucza interfejsu API.
• 140090250 – wprowadzono aktualizację, która dodaje dzienniki diagnostyczne do przetwarzania limitów. Dzięki tej zmianie można teraz powiązać dane wyjściowe logów limitów z pozostałymi logami Edge Microgateway.

3.0.7

W czwartek 12 września wprowadziliśmy te poprawki i ulepszenia w Edge Microgateway.

Wersje komponentów:

W tabeli poniżej znajdziesz numery wersji poszczególnych projektów komponentów powiązanych z Edge Microgateway 3.0.7. Pamiętaj, że każdy komponent jest osobnym projektem, więc numery wersji mogą nie odpowiadać wersji głównego produktu:

Poprawki błędów i ulepszenia:

• 140075602. Wtyczka OAuth została zaktualizowana, aby w odpowiednich przypadkach zwracać kod stanu 5xx. Wcześniej wtyczka zwracała kody stanu 4xx we wszystkich przypadkach innych niż 200. Teraz w przypadku każdej odpowiedzi na wiadomość, która nie ma stanu 200, zwracany będzie dokładny kod 4xx lub 5xx w zależności od błędu.

  Ta funkcja jest domyślnie wyłączona. Aby włączyć tę funkcję, dodaj właściwość oauth.useUpstreamResponse: true do konfiguracji Edge Microgateway. Na przykład:

  oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    gracePeriod: 10
    useUpstreamResponse: true

• 140090623. W wersji 3.0.6 dodaliśmy nową właściwość konfiguracji: quota.quotaUri. Ustaw tę właściwość konfiguracji, jeśli chcesz zarządzać limitami za pomocą edgemicro-auth serwera proxy wdrożonego w Twojej organizacji. Jeśli ta właściwość nie jest ustawiona, punkt końcowy limitu domyślnie przyjmuje wartość wewnętrznego punktu końcowego Edge Microgateway. Na przykład:

  edge_config:
    quotaUri: https://%s-%s.apigee.net/edgemicro-auth

  W wersji 3.0.7 zaktualizowano edgemicro-auth, aby akceptować tę nową konfigurację. Aby używać właściwości quotaUri, musisz przejść na najnowszą wersję serwera proxy edgemicro-auth. Szczegółowe informacje znajdziesz w artykule Uaktualnianie serwera proxy edgemicro-auth.

• 140470888 – do wywołań związanych z limitami dodano nagłówek autoryzacji, aby zapewnić uwierzytelnianie. Zmodyfikowano też serwer proxy edgemicro-auth, aby usunąć z identyfikatora limitu słowo „organization”. Ponieważ punkt końcowy limitu znajduje się w organizacji klienta, identyfikator limitu nie jest już potrzebny.
• 140823165 – nazwa tej usługi:

  edgemicro:
      keepAliveTimeout

  została nieprawidłowo udokumentowana w wersji 3.0.6. Prawidłowa nazwa usługi to:

  edgemicro:
      keep_alive_timeout

• 139526406 - Naprawiliśmy błąd, który powodował nieprawidłowe zliczanie limitu, jeśli aplikacja dewelopera miała wiele produktów. Limit jest teraz prawidłowo egzekwowany w przypadku każdego produktu w aplikacji, która ma wiele produktów. Kombinacja „appName + productName” jest używana jako identyfikator limitu.

3.0.6

W czwartek 29 sierpnia wprowadziliśmy te poprawki i ulepszenia w mikro-bramie Edge:

• 138633700 – dodano nową właściwość konfiguracji: keepAliveTimeout. Ta właściwość umożliwia ustawienie limitu czasu Edge Microgateway (w milisekundach). (Domyślnie: 5000 milisekund)

  Na przykład:

  edgemicro:
    keep_alive_timeout: 600

• 140090623 – dodano nową właściwość konfiguracji quotaUri. Ustaw tę właściwość konfiguracji, jeśli chcesz zarządzać limitami za pomocą serwera proxy edgemicro-auth wdrożonego w Twojej organizacji. Jeśli ta właściwość nie jest ustawiona, punkt końcowy limitu domyślnie przyjmuje wewnętrzny punkt końcowy Edge Microgateway. Na przykład:

  edge_config:
    quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
  

  Aby korzystać z tej funkcji, musisz najpierw wdrożyć w organizacji najnowszą wersję edgemicro-auth proxy. Szczegółowe informacje znajdziesz w artykule Uaktualnianie serwera proxy edgemicro-auth.

• 138722809. Dodaliśmy nową właściwość konfiguracji: stack_trace. Ta właściwość pozwala określić, czy ślady stosu mają się pojawiać w plikach dziennika. Na przykład:

  stack_trace: false

  Jeśli parametr stack_trace ma wartość true, w logach zostanie wydrukowany ślad stosu. Jeśli zasada ma wartość false, ślad stosu nie będzie drukowany w logach.

3.0.5

W czwartek 15 sierpnia wprowadziliśmy te poprawki i ulepszenia w Edge Microgateway.

• 139005279 – rozwiązaliśmy problem polegający na tym, że polecenie edgemicro status nie zwracało prawidłowej liczby procesów roboczych.
• 138437710 – rozwiązaliśmy problem w klasie ExitCounter, który uniemożliwiał zapisanie prawidłowego dziennika.

• 139064652. Dodano możliwość dodawania poziomów rejestrowania trace i debug w przypadku zdarzeń i logów systemowych. Na razie dodaliśmy tylko możliwość dodawania tych poziomów logowania. Obecnie dostępne poziomy logowania to info, warn i error.
• 139064616. Dane wyjściowe logu zostały ujednolicone dla wszystkich instrukcji logowania w konsoli. Instrukcje logowania w konsoli zawierają teraz te atrybuty:
• Sygnatura czasowa
• Nazwa komponentu
• Identyfikator procesu
• Komunikat w logu konsoli

• 138413755. Ulepsz komunikaty dziennika związane z kluczem i tajnym kluczem JWT w przypadku tych poleceń interfejsu CLI: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey i configure.

• 138413577. Dodanie i ulepszenie obsługi błędów w przypadku przekroczenia limitu czasu usługi backendu.
• 138413303. Dodanie i ulepszenie obsługi błędów w przypadku przekroczenia limitu czasu odpowiedzi i gniazda.
• 138414116. Dodanie i ulepszenie obsługi błędów „odmowa połączenia”.

3.0.4

W czwartek 1 sierpnia wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

• 134445926 – ulepszenia wewnętrznego uwierzytelniania Edge Microgateway.
• 137582169. Rozwiązaliśmy problem, który powodował uruchamianie niechcianych procesów. Dodatkowe procesy spowodowały ponowne wczytanie wtyczek i nadmierne wykorzystanie pamięci. Edge Microgateway utrzymuje teraz liczbę procesów w oczekiwanym zakresie.
• 137768774. Ulepszenia wiadomości w logu:
  • oczyszczone logi transakcji (żądania);
  • Dodano więcej wiadomości dziennika w miejscach, w których były potrzebne.
  • Przeniesiono komunikaty logu transakcji (żądania) z danych wyjściowych konsoli do odpowiedniego pliku logu.
  • Zaktualizowaliśmy logi konsoli, aby korzystały z scentralizowanej funkcji logowania.
• 138321133, 138320563 – podstawowa zmiana wewnętrzna dotycząca bufora limitu, która umożliwi wprowadzenie w przyszłości ulepszeń limitów.

3.0.3

We wtorek 23 lipca wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

• Ulepszenia logowania: istniejące dzienniki czasu działania korzystają z nowej funkcji eventLog(), która rejestruje i loguje dane czasu działania w spójnym formacie. Informacje w logu obejmują:
  • Sygnatura czasowa (zgodna z normą ISO 8601: RRRR-MM-DDTHH:mm:ss.sssZ).
  • Poziom logu (error, warn lub info).
  • Nazwa hosta – nazwa hosta z nagłówka żądania.
  • Identyfikator procesu – jeśli używasz klastra procesów Node.js, jest to identyfikator procesu, w którym nastąpiło logowanie.
  • Nazwa organizacji Apigee.
  • Nazwa środowiska w organizacji.
  • Nazwa proxy interfejsu API.
  • Adres IP klienta.
  • ClientId.
  • Identyfikator korelacji (obecnie nie jest ustawiony).
  • Nazwa komponentu Edge Microgateway.
  • Wiadomość niestandardowa – niektóre obiekty mogą drukować dodatkowe informacje przekazywane do tej właściwości błędu.
  • Metoda żądania (w przypadku żądania HTTP).
  • Kod stanu odpowiedzi (w przypadku żądania HTTP).
  • Komunikat o błędzie.
  • Kod błędu – jeśli obiekt zawiera kod błędu, jest on drukowany w tej właściwości.
  • Czas trwania.
  • System operacyjny znacznik końca wiersza.

  Wartości właściwości null powodują wyświetlanie pustych nawiasów [].

  Poniżej znajdziesz przykład formatu logu:

  Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]

  (137770055)

• Wyniki: produkty interfejsu API nie były filtrowane na podstawie środowiska. Ten problem został rozwiązany. (135038879)
• Różne integracje testów funkcjonalnych i ulepszenia jakości kodu.

3.0.2

W środę 3 lipca 2019 roku wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

Jakość kodu – kod został sprawdzony pod kątem jakości i wprowadzono w nim zmiany, aby spełniał standardy jakości wymagane przez użytkowników. Usunęliśmy błędy i ostrzeżenia dotyczące jakości kodu pochodzące z JSHint. W rezultacie wykryto i naprawiono niektóre rzeczywiste błędy w kodzie. Wszystkie moduły Apigee Edge Microgateway przeszły ten proces. Zobacz zmiany z 28 czerwca i 2 lipca w przypadku microgateway-config, microgateway-core, microgateway-plugins i microgateway. Wszystkie moduły, w których wprowadzono zmiany dotyczące jakości kodu, zostały przetestowane za pomocą narzędzi wewnętrznych, które weryfikują działanie Edge Microgateway w przypadku zastosowań klientów.

3.0.1

W piątek 21 czerwca 2019 r. wprowadziliśmy w Edge Microgateway te poprawki i ulepszenia:

• 134834551 - Change the supported Node.js versions for Edge Microgateway
  (Node.js supported versions: 8 and 12; versions 7, 9, and 11 are experimental)
• 134751883. Edge Microgateway ulega awarii podczas ponownego wczytywania pod obciążeniem
• 134518428. Punkt końcowy Products w Edge Microgateway zwraca kod 5XX, jeśli wzorzec filtra jest nieprawidłowy
• 135113408 - Workers should restart if they terminate unexpectedly
• 134945852 - tokenCacheSize is not used in oauth plug-in
• 134947757 - set cacheTTL in oauth plug-in
• 135445171 - gracePeriod calculation in OAuth is not correct
• Użyj modułu memored dostarczonego z instalacją Edge Microgateway.
• 135367906 - Security audit

Wersja 2.5.x

Nowe funkcje i ulepszenia w wersji 2.5.x

(Poprawiono w wersji 2.5.38, 06.07.2019)

Nieprawidłowo sformatowane tokeny JWT mogą powodować awarie procesów roboczych podczas korzystania z pamięci podręcznej tokenów. Naprawiono w module wtyczek mikrobramy Edge. (b/134672029)

(Dodano w wersji 2.5.37) Dodano opcję interfejsu wiersza poleceń edgemicro-cert -t.

Opcja edgemicro cert -t umożliwia określenie tokena OAuth do uwierzytelniania interfejsów API zarządzania. Zobacz też Zarządzanie certyfikatami.

(Dodano 2.5.35) Dodano obsługę debugowania Edge Microgateway za pomocą edgemicroctl.

Możesz użyć flagi mgdebug z poleceniem edgemicroctl. Zobacz też zadania integracji z Kubernetes.

(Dodano w wersji 2.5.35) Włącz kompilację systemu Windows dla edgemicroctl.

(Dodano 2.5.31) Nowy interfejs API edgemicro-auth/token

Dodaliśmy nowy interfejs API edgemicro-auth/token, który umożliwia przekazywanie klucza klienta i klucza tajnego jako nagłówka autoryzacji podstawowej zakodowanego w Base64 oraz grant_type jako parametru formularza. Zobacz Bezpośrednie uzyskiwanie tokenów dostępu.

(Poprawka w wersji 2.5.31) Konfiguracja prywatna nie uwzględnia flagi tokena

Rozwiązaliśmy problem, który powodował, że skonfigurowanie Edge Microgateway do używania tokena dostępu OAuth2 w Edge for Private Cloud nie działało prawidłowo (token nie był uwzględniany).

Docker: obsługa certyfikatów z podpisem własnym

(Dodano 2.5.29) Jeśli używasz urzędu certyfikacji, który nie jest domyślnie zaufany przez Node.js, możesz użyć parametru NODE_EXTRA_CA_CERTS podczas uruchamiania kontenera Dockera z Edge Microgateway. Więcej informacji znajdziesz w artykule Używanie urzędu certyfikacji, który nie jest zaufany przez Node.js.

Docker: obsługa TLS

(Dodano w wersji 2.5.29) Edge Microgateway działający w kontenerze Dockera obsługuje teraz TLS w przypadku przychodzących żądań do serwera Edge Microgateway (żądania wychodzące) i wychodzących żądań z Edge Microgateway do aplikacji docelowej (żądania przychodzące).

Poniższe przykłady szczegółowo wyjaśniają, jak skonfigurować te ustawienia TLS:

• Przykładowa konfiguracja TLS w kierunku północnym
• Przykładowa konfiguracja TLS w kierunku południowym

Z tych przykładów dowiesz się, jak używać punktu podłączenia kontenera /opt/apigee/.edgemicro do wczytywania certyfikatów, do których odwołuje się plik konfiguracyjny Edge Microgateway.

Docker: obsługa przekazywania żądań

(Dodano 2.5.27) Jeśli używasz Edge Microgateway w kontenerze Docker, możesz użyć tych opcji, aby kontrolować zachowanie serwera proxy, gdy mikrogateway działa za zaporą:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Szczegółowe informacje znajdziesz w artykule Uruchamianie Edge Micro jako kontenera Dockera.

Docker: zaktualizowane instrukcje dotyczące wtyczki

(Dodano 2.5.27) Jeśli używasz Edge Microgateway w kontenerze Docker, masz teraz 2 możliwości wdrażania wtyczek. Jedna z opcji, korzystająca z punktu montowania Dockera, jest nowa. Druga opcja istniała wcześniej i w zasadzie nie uległa zmianie, ale plik Dockerfile został zaktualizowany. Szczegółowe informacje znajdziesz w tych artykułach:

• Opcja A. Zamontuj katalog wtyczek na woluminie (nowość)
• Opcja B. Wbuduj wtyczki w kontenerze (zaktualizowana)

Nowa obsługa tokenów OAuth w przypadku polecenia uaktualniania KVM

(Dodano 25.02.2027) Możesz użyć tokena OAuth z poleceniem upgradekvm. Więcej informacji znajdziesz w artykule Uaktualnianie KVM.

Segregowanie interfejsów API w Edge Analytics

(Dodano 2.5.26) Nowe flagi wtyczki analitycznej umożliwiają wyodrębnienie konkretnej ścieżki interfejsu API, tak aby na panelach Edge Analytics była widoczna jako osobny serwer proxy. Możesz na przykład oddzielić interfejsy API kontroli stanu, aby nie mylić ich z rzeczywistymi wywołaniami interfejsu API. Więcej informacji znajdziesz w artykule Wykluczanie ścieżek z analizy.

Konfigurowanie lokalnego serwera proxy

(Dodano 2.5.25) W przypadku lokalnego serwera proxy nie musisz ręcznie tworzyć serwera proxy obsługującego mikrobramę w Apigee Edge. Zamiast tego mikrobrama będzie używać ścieżki podstawowej lokalnego serwera proxy. Więcej informacji znajdziesz w artykule Korzystanie z trybu lokalnego serwera proxy.

Korzystanie z trybu samodzielnego

(Dodano 2.5.25) Możesz uruchomić Edge Microgateway całkowicie odłączony od wszelkich zależności Apigee Edge. W tym scenariuszu, zwanym trybem samodzielnym, możesz uruchamiać i testować Edge Microgateway bez połączenia z internetem. Więcej informacji znajdziesz w artykule Uruchamianie Edge Microgateway w trybie samodzielnym.

Cofanie kluczy

(Dodano 2.5.19) Dodano nowe polecenie CLI, które cofa klucz i tajne dane logowania w konfiguracji Edge Microgateway.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]

Obsługa Dockera

(Dodano 2.5.19) Najnowszą wersję Edge Microgateway możesz teraz pobrać jako obraz Dockera:

docker pull gcr.io/apigee-microgateway/edgemicro:latest

Obsługa Kubernetes

(Dodano 2.5.19) Edge Microgateway możesz wdrożyć jako usługę lub jako bramę pomocniczą przed usługami wdrożonymi w klastrze Kubernetes. Zobacz: Integracja Edge Microgateway z Kubernetes – omówienie.

Obsługa opcji TCP nodelay

(Dodano w wersji 2.5.16) Do konfiguracji Edge Micro dodano nowe ustawienie konfiguracji nodelay.

Domyślnie połączenia TCP używają algorytmu Nagle do buforowania danych przed ich wysłaniem. Ustawienie nodelay na true wyłącza to działanie (dane będą wysyłane natychmiast za każdym razem, gdy zostanie wywołana funkcja socket.write()). Więcej informacji znajdziesz w dokumentacji Node.js.

Aby włączyć nodelay, zmodyfikuj plik konfiguracji Edge Micro w ten sposób:

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

Nowe opcje interfejsu wiersza poleceń do monitorowania ciągłego

(Dodano 2.5.12) Do polecenia edgemicro forever dodano nowe parametry. Te parametry umożliwiają określenie lokalizacji pliku forever.json oraz rozpoczęcie lub zatrzymanie procesu w tle Forever. Zobacz też Stałe monitorowanie

Przykłady:

Aby rozpocząć Forever:

edgemicro forever -f ~/mydir/forever.json -a start

Aby zatrzymać Forever:

edgemicro forever -a stop

Rotacja klucza JWT

Dodaliśmy nową funkcję, która umożliwia rotację par kluczy publiczny/prywatny używanych do generowania tokenów JWT na potrzeby zabezpieczeń OAuth w Edge Microgateway. Zobacz wykonywanie rotacji kluczy JWT.

Filtrowanie pobranych serwerów proxy interfejsu API

Domyślnie Edge Microgateway pobiera wszystkie proxy w organizacji Edge, które zaczynają się od prefiksu „edgemicro_”. Możesz zmienić to ustawienie domyślne, aby pobierać proxy, których nazwy pasują do wzorca. Zobacz Filtrowanie pobranych serwerów proxy.

Określanie produktów bez serwerów proxy interfejsu API

W Apigee Edge możesz utworzyć usługę API, która nie zawiera żadnych serwerów proxy API. Ta konfiguracja usługi umożliwia używanie klucza interfejsu API powiązanego z tą usługą w przypadku dowolnego serwera proxy wdrożonego w Twojej organizacji. Od wersji 2.5.4 Edge Microgateway obsługuje tę konfigurację usługi.

Obsługa stałego monitorowania

Edge Microgateway ma plik forever.json, który możesz skonfigurować, aby określić, ile razy i w jakich odstępach czasu Edge Microgateway ma być ponownie uruchamiany. Ten plik konfiguruje usługę o nazwie forever-monitor, która zarządza programem Forever. Zobacz Stałe monitorowanie.

Centralne zarządzanie plikiem konfiguracji Edge Micro

Jeśli używasz wielu instancji Edge Microgateway, możesz zarządzać ich konfiguracjami z jednego miejsca. Możesz to zrobić, określając punkt końcowy HTTP, z którego Edge Micro może pobrać plik konfiguracji. Zobacz Określanie punktu końcowego pliku konfiguracji.

Obsługa opcji interfejsu wiersza poleceń forever

(Dodano w wersji 2.5.8) Użyj polecenia edgemicro forever [package.json], aby określić lokalizację pliku forever.json. Przed dodaniem tego polecenia plik config musiał znajdować się w katalogu głównym Edge Microgateway.

Na przykład:

edgemicro forever ~/mydir/forever.json

Dodanie opcji configUrl do polecenia reload

(Dodano w wersji 2.5.8) Możesz teraz używać opcji --configUrl lub -u z poleceniem edgemicro reload.

Okres prolongaty w przypadku rozbieżności w czasie tokena JWT

(Dodano w wersji 2.5.7) Atrybut gracePeriod w konfiguracji OAuth pomaga zapobiegać błędom spowodowanym przez niewielkie rozbieżności między zegarem systemowym a czasami Not Before (nbf) lub Issued At (iat) określonymi w tokenie autoryzacji JWT. Ustaw ten atrybut na liczbę sekund, aby uwzględnić takie rozbieżności. Zobacz atrybuty OAuth.

(Dodano w wersji 2.5.7) Atrybut gracePeriod w konfiguracji OAuth pomaga zapobiegać błędom spowodowanym przez niewielkie rozbieżności między zegarem systemowym a czasami Not Before (nbf) lub Issued At (iat) określonymi w tokenie autoryzacji JWT. Ustaw ten atrybut na liczbę sekund, aby uwzględnić takie rozbieżności. Zobacz atrybuty OAuth.

Poprawione błędy w wersji 2.5.x

• (Problem 236) Poprawienie literówki w instrukcji czyszczenia pamięci podręcznej.
• (Problem nr 234) Ponowne wczytywanie powoduje awarię Edge Microgateway w wersji 2.5.35.
• (Problem nr 135) Błąd „Invalid virtual host reference "secure"” (Nieprawidłowe odwołanie do hosta wirtualnego „secure”) podczas używania opcji -v. Ta poprawka modyfikuje serwer proxy edgemicro-auth przed wdrożeniem, aby zapewnić, że hosty wirtualne dokładnie odpowiadają temu, co jest określone we fladze „-v”. Dodatkowo możesz określić dowolną liczbę i dowolną nazwę hosta wirtualnego (nie jest już ograniczona do domyślnego i bezpiecznego).
• (Problem 141) Polecenie edgemicro reload nie obsługuje opcji pliku konfiguracji -c. Naprawiliśmy ten problem.
• (Problem nr 142) Edge Microgateway zgłasza w momencie instalacji, że używa przestarzałego szyfrowania. Naprawiliśmy ten problem.
• (Problem nr 145) Limit nie działa w przypadku Edge Microgateway. Naprawiliśmy ten problem.
• (Problem na forum Apigee: https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-both-api-proxies-a.html#answer-33336) Token JWT weryfikowany w odniesieniu do serwerów proxy interfejsu API i identyfikatora URI zasobu w OAUTH. Ten problem został rozwiązany.
• (Problem na forum Apigee: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Mikrogateway nie działa z OAuth. Naprawiliśmy ten problem.
• Naprawiono pidPath w systemie Windows.
• (Problem 157) Naprawiono problem, który powodował wyświetlanie tego komunikatu o błędzie:ReferenceError: deployProxyWithPassword nie jest zdefiniowane.
• (Problem nr 169) Aktualizacja zależności Node.js (npm audit)
• Serwer proxy edgemicro-auth korzysta teraz z zasad JWT Edge. Serwer proxy nie zależy już od Node.js w zakresie obsługi JWT.

Wersja 2.4.x

Nowe funkcje i ulepszenia w wersji 2.4.x

1. Ustawianie niestandardowego aliasu dla serwera proxy edgemicro-auth (PR 116)

Możesz zmienić domyślną ścieżkę podstawową dla serwera proxy edgemicro-auth. Domyślnie ścieżka podstawowa to /edgemicro-auth. Aby ją zmienić, użyj flagi -x w poleceniu edgemicro configure.

Przykład:

edgemicro configure -x /mypath …

2. Obsługa symboli wieloznacznych w przypadku ścieżek podstawowych (PR 77)

W ścieżce podstawowej serwera proxy edgemicro_* możesz użyć co najmniej jednego symbolu wieloznacznego „*”. Na przykład ścieżka podstawowa /team/*/members umożliwia klientom wywoływanie adresów https://[host]/team/blue/members i https://[host]/team/green/members bez konieczności tworzenia nowych serwerów proxy interfejsu API na potrzeby obsługi nowych zespołów. Pamiętaj, że /**/ nie jest obsługiwane.

3. Ścieżka konfiguracji niestandardowej dodana do interfejsu CLI w konfiguracji Private Cloud (PR 99)

Domyślnie plik konfiguracji mikrobramy znajduje się w lokalizacji ./config/config.yaml. W przypadku poleceń init, configure i start możesz teraz określić niestandardową ścieżkę konfiguracji w wierszu poleceń za pomocą flag -c lub --configDir. Rozwiązaliśmy problem, który powodował, że niestandardowy katalog konfiguracji w instalacjach chmury prywatnej nie był rozpoznawany.

Przykład:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

4. Uwzględnianie zmiennych *_PROXY (PR 61)

Jeśli Edge Microgateway jest zainstalowany za zaporą i nie może komunikować się z Apigee Edge w chmurze publicznej, masz do wyboru 2 opcje:

Opcja 1:

Pierwsza opcja polega na ustawieniu w pliku konfiguracyjnym mikrobramy wartości „true” dla opcji edgemicro: proxy_tunnel:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: true

Gdy wartość parametru proxy_tunnel to true, Edge Microgateway używa metody HTTP CONNECT do tunelowania żądań HTTP przez jedno połączenie TCP. (To samo dotyczy sytuacji, gdy zmienne środowiskowe do konfigurowania serwera proxy mają włączony protokół TLS).

Opcja 2:

Druga opcja to określenie serwera proxy i ustawienie wartości proxy_tunnel na false w pliku konfiguracyjnym mikrobramy. Na przykład:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: false

W takim przypadku możesz ustawić te zmienne, aby kontrolować hosty dla każdego serwera proxy HTTP, którego chcesz używać, lub hosty, które nie powinny obsługiwać serwerów proxy Edge Microgateway: HTTP_PROXY, HTTPS_PROXY i NO_PROXY. Możesz ustawić NO_PROXY jako listę domen rozdzielonych przecinkami, do których Edge Microgateway nie powinien przekazywać żądań. Na przykład:

export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'

Więcej informacji o tych zmiennych znajdziesz w tych artykułach:

https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables

5. Ustawianie niestandardowego limitu czasu dla żądań kierowanych na środowisko docelowe (PR 57)

Możesz ustawić niestandardowy limit czasu dla żądań kierowania za pomocą tej konfiguracji:

edgemicro:
    request_timeout: 10

Czas oczekiwania jest podawany w sekundach. Jeśli upłynie czas oczekiwania, Edge Microgateway odpowie kodem stanu 504.

6. Uwzględnianie niestandardowych komunikatów o stanie HTTP w odpowiedzi docelowej (PR 53)

Edge Microgateway uwzględnia niestandardowe komunikaty o stanie HTTP ustawione w odpowiedzi docelowej. W poprzednich wersjach komunikaty o stanie wysyłane z urządzenia docelowego były zastępowane domyślnymi ustawieniami Node.js.

7. Nagłówek X-Forwarded-For może ustawić parametr client_ip na potrzeby analityki

Jeśli nagłówek X-Forwarded-For jest obecny, ustawi zmienną client_ip, która jest raportowana w Edge Analytics. Ta funkcja umożliwia poznanie adresu IP klienta, który wysłał żądanie do Edge Microgateway.

8. Zmiany w pluginie OAuth

Wtyczka OAuth obsługuje weryfikację klucza interfejsu API i tokena dostępu OAuth. Przed tą zmianą wtyczka akceptowała obie formy zabezpieczeń. Dzięki tej zmianie możesz zezwolić tylko na jeden z tych modeli zabezpieczeń (przy zachowaniu zgodności wstecznej).

Wtyczka OAuth dodaje 2 nowe flagi:

• allowOAuthOnly – jeśli ma wartość true, każdy interfejs API musi zawierać nagłówek Authorization z tokenem dostępu Bearer.

• allowAPIKeyOnly – jeśli ta wartość jest ustawiona na true, każdy interfejs API musi zawierać nagłówek x-api-key (lub niestandardową lokalizację) z kluczem interfejsu API.

Te flagi ustawia się w pliku konfiguracyjnym Edge Microgateway w ten sposób:

oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    keep-authorization-header: false
    allowOAuthOnly: false
    allowAPIKeyOnly: false

9. Ulepszono serwer proxy edgemicro-auth (PR 40).

Wprowadziliśmy ulepszenia w usłudze proxy edgemicro-auth. Przed wprowadzeniem tych zmian serwer proxy przechowywał klucze w Edge Secure Store, czyli zaszyfrowanym magazynie. Teraz serwer proxy przechowuje klucze na zaszyfrowanej mapie klucz-wartość (KVM) Edge.

10. Przepisywanie domyślnego docelowego adresu URL w przypadku wtyczki (PR 74)

Możesz też zastąpić port docelowego punktu końcowego i wybrać protokół HTTP lub HTTPS. Zmodyfikuj te zmienne w kodzie wtyczki: req.targetPort i req.targetSecure. Aby wybrać HTTPS, ustaw wartość req.targetSecure na true. Aby wybrać HTTP, ustaw ją na false. Jeśli ustawisz wartość req.targetSecure na true, więcej informacji znajdziesz w tym wątku dyskusji.

11. Wstępna obsługa uwierzytelniania za pomocą tokena OAuth (PR 125)

Możesz skonfigurować Edge Microgateway tak, aby do uwierzytelniania używał tokena OAuth zamiast nazwy użytkownika i hasła. Aby użyć tokena OAuth, użyj tego parametru w poleceniu edgemicro configure:

-t, --token <token>

Na przykład:

edgemicro configure -o docs -e test -t <your token>

Poprawione błędy w wersji 2.4.3

• Rozwiązaliśmy problem, który powodował, że do prawidłowego działania serwera proxy edgemicro-auth wymagana była płatna organizacja. Teraz możesz używać Edge Microgateway również w organizacjach testowych. (PR 5)
• Rozwiązaliśmy problem polegający na tym, że strumień nie kończył przetwarzania danych, ale mimo to wykonywane były procedury obsługi zakończenia. Spowodowało to wysłanie odpowiedzi częściowej. (PR 71)
• Rozwiązaliśmy problem, który powodował, że niestandardowy katalog konfiguracji w przypadku instalacji chmury prywatnej nie był rozpoznawany. (PR 110)
• Rozwiązaliśmy problem z dwukierunkowym protokołem SSL między klientem a Edge Microgateway. (PR 70)
• Rozwiązaliśmy problem, który powodował, że w przypadku weryfikacji klucza interfejsu API wymagany był ukośnik na końcu ścieżki podstawowej serwera proxy. Teraz na końcu ścieżki podstawowej nie jest potrzebny ukośnik. (PR 48)

Wersja 2.3.5

Nowe funkcje i ulepszenia w wersji 2.3.5

Filtrowanie proxy

Możesz filtrować, które serwery proxy obsługujące mikrobramę będą przetwarzane przez instancję Edge Microgateway. Po uruchomieniu Edge Microgateway pobiera wszystkie serwery proxy obsługujące mikrobramę w organizacji, z którą jest powiązana. Skonfiguruj w ten sposób, aby ograniczyć liczbę serwerów proxy, które będzie przetwarzać mikrobrama. Na przykład ta konfiguracja ogranicza liczbę serwerów proxy, które będzie przetwarzać mikrobrama, do 3: edgemicro_proxy-1, edgemicro_proxy-2 i edgemicro_proxy-3:

proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

Maskowanie danych Analytics

Nowa konfiguracja umożliwia ukrywanie informacji o ścieżce żądania w analizach Edge. Aby zamaskować identyfikator URI żądania lub ścieżkę żądania, dodaj do konfiguracji mikrobramy te elementy: Pamiętaj, że identyfikator URI składa się z nazwy hosta i ścieżki żądania.

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

Wersja 2.3.3

Nowe funkcje i ulepszenia w wersji 2.3.3

Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.

Wyłączanie automatycznego sprawdzania zmian

Możesz wyłączyć automatyczne sprawdzanie zmian, ustawiając ten atrybut w konfiguracji mikrobramy:

disabled_config_poll_interval: true

Domyślnie okresowe sprawdzanie wykrywa wszelkie zmiany wprowadzone w Edge (zmiany w produktach, serwerach proxy obsługujących mikrobramy itp.) oraz zmiany wprowadzone w lokalnym pliku konfiguracji. Domyślny interwał odpytywania to 600 sekund (5 minut).

Przepisywanie docelowych adresów URL w przypadku wtyczek

Możesz dynamicznie zastąpić domyślny docelowy adres URL w wtyczce, modyfikując te zmienne w kodzie wtyczki: req.targetHostname i req.targetPath.

Nowy podpis funkcji wtyczki

Dodano nową sygnaturę funkcji wtyczki, która udostępnia odpowiedź docelową jako argument. Ułatwia to wtyczkom dostęp do docelowej odpowiedzi.

function(sourceRequest, sourceResponse, targetResponse, data, cb)

Uproszczone domyślne dane wyjściowe logowania

Domyślnie usługa rejestrowania pomija teraz pliki JSON pobranych serwerów proxy, produktów i JWT. Możesz zmienić domyślne ustawienie, aby te obiekty były wyświetlane, ustawiając DEBUG=* podczas uruchamiania Edge Microgateway. Na przykład:

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

Ścieżka konfiguracji niestandardowej dodana do interfejsu CLI

Domyślnie plik konfiguracji mikrobramy znajduje się w folderze ./config/config.yaml. W przypadku poleceń init, configure i start możesz teraz określić niestandardową ścieżkę konfiguracji w wierszu poleceń. Na przykład:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

Poprawione błędy w wersji 2.3.3

• Usunięto wyciek pamięci, który występował podczas obsługi dużych żądań i odpowiedzi.
• Naprawiono kolejność wykonywania wtyczek. Działa teraz w sposób opisany w dokumentacji.
• Wtyczka accumulate-request nie zawiesza się już w przypadku żądań GET.
• W wtyczce accumulate-response rozwiązaliśmy problem, który powodował błędy z powodu braku treści odpowiedzi.

Wersja 2.3.1

Uwaga dotycząca instalacji

W niektórych poprzednich wersjach Edge Microgateway można było zainstalować oprogramowanie, pobierając plik ZIP. Te pliki ZIP nie są już obsługiwane. Aby zainstalować Edge Microgateway, musisz użyć:

npm install -g edgemicro

Więcej informacji znajdziesz w temacie dotyczącym instalacji.

Nowe funkcje i ulepszenia w wersji 2.3.1

Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.

Filtrowanie serwerów proxy

Nowa konfiguracja umożliwia filtrowanie serwerów proxy, które Edge Microgateway będzie wczytywać podczas uruchamiania. Wcześniej mikrobrama wczytywała wszystkie serwery proxy obsługujące mikrobramę (serwery proxy o nazwie edgemicro_*) pobrane z organizacji/środowiska Edge określonego w poleceniu edgemicro configure. Ta nowa funkcja umożliwia filtrowanie listy serwerów proxy, dzięki czemu Edge Microgateway wczytuje tylko te, które określisz. Po prostu dodaj element proxies do pliku konfiguracji mikrobramy w ten sposób:

edge micro:
proxies:
    - edgemicro_[name]
    - edgemicro_[name]
    ...

Załóżmy na przykład, że w organizacji/środowisku Edge masz 50 proxy edgemicro_*, w tym proxy o nazwach edgemicro_foo i edgemicro_bar. Możesz poinformować mikrobramę, aby używała tylko tych 2 serwerów proxy, w ten sposób:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Po uruchomieniu mikrobrama będzie mogła wywoływać tylko określone serwery proxy. Wszelkie próby wywołania innych serwerów proxy obsługujących mikrobramę pobranych z organizacji lub środowiska Edge spowodują błąd.

Ustawianie nagłówków żądań docelowych we wtyczkach

Jeśli chcesz dodać lub zmodyfikować nagłówki żądań docelowych, możesz zastosować 2 podstawowe wzorce: jeden, w którym przychodzące żądanie zawiera dane (jak w przypadku żądania POST), i drugi, w którym ich nie zawiera (jak w przypadku prostego żądania GET).

Rozważmy przypadek, w którym przychodzące żądanie zawiera dane, a Ty chcesz ustawić nagłówki żądania w żądaniu docelowym. W poprzednich wersjach Edge Microgateway nie można było w tym przypadku niezawodnie ustawić nagłówków docelowych.

Kluczem do tego wzorca jest najpierw zgromadzenie wszystkich przychodzących danych od klienta. Następnie w funkcji onend_request() użyj nowej funkcji request.setOverrideHeader(name, value), aby dostosować nagłówki.

Oto przykładowy kod wtyczki, który pokazuje, jak to zrobić. Nagłówki ustawione w onend_request są wysyłane do miejsca docelowego:

module.exports.init = function(config, logger, stats) {


  function accumulate(req, data) {
    if (!req._chunks) req._chunks = [];
    req._chunks.push(data);
  }

  return {

    ondata_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      next(null, null);
    },

    onend_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      var content = Buffer.concat(req._chunks);
      delete req._chunks;
      req.setOverrideHeader('foo', 'bar');
      req.setOverrideHeader('content-length', content.length);
      next(null, content);
    },


    onerror_request: function(req, res, data, next) {
      next(null, null);
    }

  };

}

Jeśli żądanie nie zawiera danych, możesz ustawić nagłówki docelowe w onrequest()obsłudze. Ten wzorzec nie jest nowy – był już wcześniej opisany i jest używany w przykładowych wtyczkach dostarczanych z Edge Microgateway.

onrequest: function(req, res, next) {
      debug('plugin onrequest');
      req.headers['x-foo-request-id'] = "bar";
      req.headers['x-foo-request-start'] = Date.now();
      next();
    }

Funkcja ponownego ładowania bez przestoju

Po wprowadzeniu zmiany konfiguracji Edge Microgateway możesz załadować konfigurację bez utraty żadnych wiadomości. W związku z tą zmianą Edge Microgateway zawsze uruchamia się w trybie klastra, a opcja --cluster została usunięta z polecenia edgemicro start.

Dodaliśmy też 3 nowe polecenia interfejsu wiersza poleceń. Te polecenia musisz uruchomić w tym samym katalogu, w którym zostało wykonane polecenie startowe edgemicro:

• edgemicro status – sprawdza, czy Edge Microgateway jest uruchomiony.
• edgemicro stop – zatrzymuje klaster Edge Microgateway.
• edgemicro reload – ponownie wczytuje konfigurację Edge Microgateway bez przestoju.

Automatyczne ponowne wczytywanie konfiguracji bez przestojów

Edge Microgateway okresowo wczytuje nową konfigurację i wykonuje ponowne wczytywanie, jeśli coś się zmieniło. Sondaż wykrywa wszelkie zmiany wprowadzone w Edge (zmiany w produktach, serwerach proxy obsługujących mikrobramy itp.), a także zmiany wprowadzone w lokalnym pliku konfiguracji. Domyślny interwał odpytywania to 600 sekund (5 minut). Domyślne ustawienie możesz zmienić w pliku konfiguracyjnym mikrobramy w ten sposób:

edgemicro:
    config_change_poll_interval: [seconds]

Dodano informacje o wersji do interfejsu wiersza poleceń

Do interfejsu CLI dodano flagę --version. Aby uzyskać bieżącą wersję Edge Microgateway, użyj tego polecenia:

edgemicro --version

Nowe opcje protokołu SSL serwera Edge Microgateway

Edge Microgateway obsługuje teraz te opcje SSL serwera oprócz key i cert:

Wysyłanie plików dziennika do stdout

Dane dziennika możesz wysyłać do standardowego wyjścia za pomocą nowego ustawienia konfiguracji:

edgemicro:
  logging:
    to_console: true  

Zobacz Zarządzanie plikami dziennika.

Wersja 2.1.2

Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.

Zezwalaj na niestandardowy punkt końcowy interfejsu API na potrzeby konfiguracji

W przypadku serwera proxy autoryzacji dostępne są nowe konfigurowalne punkty końcowe, które obsługują korzystanie z niestandardowej usługi uwierzytelniania. Są to:

• edgeconfig:verify_api_key_url
• edgeconfig:products

Więcej informacji znajdziesz w artykule Korzystanie z niestandardowej usługi uwierzytelniania.

Wersja 2.1.1

Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.

Wdrażanie serwera proxy uwierzytelniania zgodnego z wieloma platformami

Wprowadziliśmy ulepszenie, dzięki któremu polecenie używane do wdrażania serwera proxy autoryzacji Edge Microgateway w Edge jest zgodne z systemami Windows.

Wersja 2.1.0

Nowe funkcje i ulepszenia w wersji 21.0

Oto nowe funkcje i ulepszenia:

Określanie opcji SSL/TLS klienta

Możesz określić opcje klienta dla połączeń SSL/TSL z celami za pomocą nowego zestawu opcji konfiguracji. Zobacz Korzystanie z opcji SSL/TLS klienta.

Wersja 2.0.11

Uwaga dotycząca instalacji w wersji 2.0.11

W niektórych poprzednich wersjach Edge Microgateway można było zainstalować oprogramowanie, pobierając plik ZIP. Te pliki ZIP nie są już obsługiwane. Aby zainstalować Edge Microgateway, musisz użyć:

npm install -g edgemicro

Więcej informacji znajdziesz w temacie dotyczącym instalacji.

Nowe funkcje i ulepszenia w wersji 2.0.11

Oto nowe funkcje i ulepszenia:

Określanie portu podczas uruchamiania

Polecenie start umożliwia określenie numeru portu, który zastąpi port podany w pliku konfiguracji. Numer portu możesz też podać za pomocą zmiennej środowiskowej PORT. Więcej informacji znajdziesz w poleceniu start.

Opcjonalne zachowywanie nagłówków uwierzytelniania

Nowe ustawienie konfiguracji keepAuthHeader umożliwia zachowanie nagłówka autoryzacji wysłanego w żądaniu. Jeśli ma wartość true, nagłówek Auth jest przekazywany do miejsca docelowego. Zobacz atrybuty oauth.

Możliwość korzystania z niestandardowej usługi autoryzacji

Jeśli chcesz używać własnej usługi niestandardowej do obsługi uwierzytelniania, zmień wartość authUri w pliku konfiguracyjnym Edge Microgateway tak, aby wskazywała Twoją usługę. Szczegółowe informacje znajdziesz w artykule Korzystanie z niestandardowej usługi uwierzytelniania.

Wersja 2.0.4

25 maja 2016 r.udostępniliśmy Edge Microgateway w wersji 2.0.4.

Nowe funkcje i ulepszenia w wersji 2.0.4

Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.

Obsługa ścieżek zasobów w usługach

Edge Microgateway obsługuje teraz ścieżki zasobów w usługach. Ścieżki zasobów pozwalają ograniczyć dostęp do interfejsów API na podstawie sufiksu ścieżki serwera proxy. Szczegółowe informacje o tworzeniu produktów i konfigurowaniu ścieżek zasobów znajdziesz w artykule Tworzenie produktów interfejsu API.

Obsługa instalacji globalnej npm

Możesz teraz zainstalować Edge Microgateway za pomocą opcji npm -g (globalnej). Szczegółowe informacje o tej opcji znajdziesz w dokumentacji npm.

Wersja 2.0.0

Wersja 2.0.0 Edge Microgateway została opublikowana 18 kwietnia 2016 r.

Nowe funkcje i ulepszenia w wersji 2.0.0

Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.

Serwer pojedynczego procesu

Edge Microgateway to teraz serwer z jednym procesem. Nie korzysta już z modelu dwuprocesowego, w którym jeden proces (wcześniej nazywany „agentem”) uruchamia Edge Microgateway, a drugi proces. Nowa architektura ułatwia automatyzację i konteneryzację.

Pliki konfiguracji z przestrzenią nazw

Pliki konfiguracji mają teraz przestrzenie nazw z użyciem organizacji i środowiska, dzięki czemu na tym samym hoście może działać wiele instancji Microgateway. Pliki konfiguracyjne znajdziesz w katalogu ~/.edgemicro po uruchomieniu polecenia konfiguracji Edge Microgateway.

Nowe zmienne środowiskowe

Obecnie są 4 zmienne środowiskowe: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY i EDGEMICRO_SECRET. Jeśli ustawisz te zmienne w swoim systemie, nie musisz określać ich wartości podczas konfigurowania i uruchamiania Edge Microgateway za pomocą interfejsu wiersza poleceń.

Konfiguracja w pamięci podręcznej

Jeśli Edge Microgateway zostanie ponownie uruchomiony bez połączenia z Apigee Edge, użyje pliku konfiguracyjnego z pamięci podręcznej .

Tryb klastra

Teraz można uruchomić Edge Microgateway w trybie klastra. Tryb klastra umożliwia korzystanie z systemów wielordzeniowych. Mikrogateway korzysta z modułu klastra Node.js. Szczegółowe informacje znajdziesz w dokumentacji Node.js.

Poprawione błędy w wersji 2.0.0

Cykl życia zdarzenia wtyczki prawidłowo obsługuje teraz kod asynchroniczny, który zawiera kod z nowym wywołaniem zwrotnym.

Wersja 1.1.2

Wersja 1.1.2 Edge Microgateway została wydana 14 marca 2016 r.

Nowe funkcje i ulepszenia w wersji 1.1.2

Poniżej znajdziesz nowe funkcje i ulepszenia w tej wersji.

Zwiększanie skuteczności

Edge Microgateway używa teraz prawidłowo agenta HTTP Node.js, co zapewnia lepsze pulowanie połączeń. To ulepszenie zwiększa wydajność i ogólną stabilność przy dużym obciążeniu.

Obsługa debugera zdalnego

Możesz skonfigurować Edge Microgateway tak, aby działał ze zdalnym debugerem, takim jak node-inspector.

Nowa lokalizacja pliku konfiguracyjnego

Po skonfigurowaniu Edge Microgateway plik agent/config/default.yaml zostanie skopiowany do ~./edgemicro/config.yaml.

Rotacja plików dziennika

Nowy atrybut konfiguracji umożliwia określenie interwału rotacji logów Edge Microgateway.

Poprawki błędów w wersji 1.1.2

W wersji 1.1.2 naprawiono te błędy: