2.18.10 • Published 1 year ago

@zowe/apiml-onboarding-enabler-nodejs v2.18.10

Weekly downloads
-
License
EPL-2.0
Repository
github
Last release
1 year ago

Onboarding Node.js enabler for Zowe API Mediation Layer

This is the onboarding Node.js enabler for Zowe API Mediation Layer (part of Zowe) that allows to register a NodeJS based service to the API Mediation Layer Discovery Service. It uses eureka-js-client.

How to use

  1. Install the onboarding Node.js enabler package as a dependency of your service:

    npm i @zowe/apiml-onboarding-enabler-nodejs --dev-save

  2. Inside your Node.js service index.js, add the following code block to register your service with Eureka:

    const apiLayerService = require("@zowe/apiml-onboarding-enabler-nodejs");
    tlsOptions = apiLayerService.tlsOptions;
    const httpsServer = https.createServer(tlsOptions, app);
    httpsServer.listen(args.port, function () {
        apiLayerService.connectToEureka();
    });

    To make sure that your application will automatically unregister from Eureka once shut down, you can use the unregisterFromEureka() function, like shown in the example below. Example:

    process.on('SIGINT', signal => {
        apiLayerService.unregisterFromEureka();
        httpsServer.close(() => {
            process.exit(0);
        });
    });   
        
  3. Create a yaml file named service-configuration.yml, add the configuration properties and place the yaml file inside a /config directory at the same level of your index.js. Below is an example of the configuration.

    **Example:**
    
    ```yaml
    serviceId: hwexpress
    title: Hello World express REST API
    eureka:
      ssl: true
      host: localhost
      ipAddress: 127.0.0.1
      port: 10011
      servicePath: '/eureka/apps/'
      maxRetries: 30
      requestRetryDelay: 1000
      registryFetchInterval: 5
    
    
    description: Hello World REST API Service implemented in Express and Node.js
    baseUrl: https://localhost:10020/hwexpress
    homePageRelativeUrl: https://localhost:10020/
    statusPageRelativeUrl: https://localhost:10020/info
    healthCheckRelativeUrl: https://localhost:10020/status
    discoveryServiceUrls:
      - https://localhost:10011/eureka
    routes:
      - gatewayUrl: /api/v1
        serviceRelativeUrl: /api/v1
    apiInfo:
      - apiId: org.zowe.hwexpress
        gatewayUrl: "api/v1"
        swaggerUrl: https://localhost:10020/swagger.json
    catalogUiTile:
      id: cademoapps
      title: Sample API Mediation Layer Applications
      description: Applications which demonstrate how to make a service integrated to the API Mediation Layer ecosystem
      version: 1.0.0
    instance:
      app: hwexpress
      vipAddress: hwexpress
      instanceId: localhost:hwexpress:10020
      homePageUrl: https://localhost:10020/
      hostName: 'localhost'
      ipAddr: '127.0.0.1'
      secureVipAddress: hwexpress
      port:
        $: 10020
        '@enabled': false
      securePort:
        $: 10020
        '@enabled': "true"
    
      dataCenterInfo:
        '@class': com.netflix.appinfo.InstanceInfo$DefaultDataCenterInfo
        name: MyOwn
      metadata:
        apiml.catalog.tile.id: 'samplenodeservice'
        apiml.catalog.tile.title: 'Zowe Sample Node Service'
        apiml.catalog.tile.description: 'NodeJS Sample service running'
        apiml.catalog.tile.version: '1.0.0'
        apiml.routes.api_v1.gatewayUrl: "api/v1"
        apiml.routes.api_v1.serviceUrl: "/api/v1"
        apiml.apiInfo.0.apiId: org.zowe.hwexpress
        apiml.apiInfo.0.gatewayUrl: "api/v1"
        apiml.apiInfo.0.swaggerUrl: https://localhost:10020/swagger.json
        apiml.service.title: 'Zowe Sample Node Service'
        apiml.service.description: 'The Proxy Server is an HTTP HTTPS, and Websocket server built upon NodeJS and ExpressJS.'
    
    ssl:
      certificate: ssl/localhost.keystore.cer
      keystore: ssl/localhost.keystore.key
      caFile: ssl/localhost.pem
      keyPassword: password
    
    ```
  4. Start your Node.js service and verify that it registers to the Zowe API Mediation Layer.

2.18.9

1 year ago

2.18.8

1 year ago

2.18.10

1 year ago

3.1.13

1 year ago

2.18.7

1 year ago

3.1.12

1 year ago

2.18.6

1 year ago

3.1.11

1 year ago

2.18.5

1 year ago

2.18.4

1 year ago

3.1.10

1 year ago

2.18.3

1 year ago

2.18.1

1 year ago

3.1.9

1 year ago

3.2.2

1 year ago

3.2.1

1 year ago

3.2.0

1 year ago

3.1.7

1 year ago

3.1.6

1 year ago

3.1.8

1 year ago

3.1.4

1 year ago

3.1.3

1 year ago

3.1.2

1 year ago

3.1.1

1 year ago

3.1.0

1 year ago

3.0.52

1 year ago

3.0.51

1 year ago

3.0.50

1 year ago

3.0.49

1 year ago

3.0.45

1 year ago

3.0.46

1 year ago

3.0.47

1 year ago

3.0.48

1 year ago

3.0.43

2 years ago

3.0.44

2 years ago

3.0.42

2 years ago

3.0.41

2 years ago

3.0.40

2 years ago

3.0.39

2 years ago

1.28.27

2 years ago

2.17.3

2 years ago

3.0.35

2 years ago

3.0.38

2 years ago

3.0.36

2 years ago

3.0.37

2 years ago

3.0.34

2 years ago

3.0.32

2 years ago

3.0.33

2 years ago

3.0.31

2 years ago

3.0.30

2 years ago

2.17.2

2 years ago

2.17.0

2 years ago

2.17.1

2 years ago

2.16.4

2 years ago

3.0.29

2 years ago

3.0.28

2 years ago

2.16.3

2 years ago

2.16.1

2 years ago

2.16.2

2 years ago

2.16.0

2 years ago

3.0.24

2 years ago

3.0.27

2 years ago

3.0.25

2 years ago

3.0.26

2 years ago

3.0.23

2 years ago

3.0.22

2 years ago

1.28.26

2 years ago

3.0.21

2 years ago

3.0.20

2 years ago

2.15.3

2 years ago

3.0.19

2 years ago

3.0.18

2 years ago

3.0.13

2 years ago

3.0.16

2 years ago

3.0.17

2 years ago

3.0.14

2 years ago

3.0.15

2 years ago

2.15.2

2 years ago

3.0.12

2 years ago

2.15.0

2 years ago

2.15.1

2 years ago

3.0.11

2 years ago

3.0.10

2 years ago

3.0.9

2 years ago

3.0.8

2 years ago

1.28.25

2 years ago

3.0.7

2 years ago

3.0.6

2 years ago

3.0.5

2 years ago

3.0.4

2 years ago

3.0.3

2 years ago

2.14.1

2 years ago

2.14.0

2 years ago

2.13.9

2 years ago

3.0.2

2 years ago

3.0.1

2 years ago

2.13.8

2 years ago

2.13.7

2 years ago

2.13.6

2 years ago

2.13.4

2 years ago

2.13.5

2 years ago

2.13.3

2 years ago

2.13.2

2 years ago

2.13.0

2 years ago

2.13.1

2 years ago

2.12.8

2 years ago

2.12.7

2 years ago

2.12.6

2 years ago

2.12.5

2 years ago

2.12.4

2 years ago

2.12.3

2 years ago

2.11.0

3 years ago

2.11.1

3 years ago

2.11.8

3 years ago

2.11.9

3 years ago

2.11.6

3 years ago

2.11.7

3 years ago

2.11.4

3 years ago

2.11.5

3 years ago

2.11.2

3 years ago

2.11.3

3 years ago

2.11.10

3 years ago

2.9.12

3 years ago

2.9.13

3 years ago

2.9.10

3 years ago

2.9.11

3 years ago

2.9.16

3 years ago

2.9.14

3 years ago

2.9.15

3 years ago

2.10.1

3 years ago

2.10.2

3 years ago

2.10.0

3 years ago

2.10.5

3 years ago

2.10.3

3 years ago

2.10.4

3 years ago

1.28.23

3 years ago

1.28.24

3 years ago

2.9.9

3 years ago

2.9.6

3 years ago

2.9.8

3 years ago

2.9.7

3 years ago

2.12.0

3 years ago

2.12.1

3 years ago

2.12.2

2 years ago

2.9.5

3 years ago

1.28.22

3 years ago

2.9.0

3 years ago

2.9.2

3 years ago

2.9.1

3 years ago

2.9.4

3 years ago

2.9.3

3 years ago

2.8.18

3 years ago

2.8.17

3 years ago

2.8.16

3 years ago

2.8.7

3 years ago

2.8.9

3 years ago

2.8.8

3 years ago

2.8.12

3 years ago

2.8.11

3 years ago

2.8.10

3 years ago

2.8.15

3 years ago

2.8.14

3 years ago

2.8.13

3 years ago

1.28.17

3 years ago

1.28.18

3 years ago

1.28.19

3 years ago

1.28.20

3 years ago

1.28.21

3 years ago

2.7.0

3 years ago

2.7.2

3 years ago

2.7.1

3 years ago

2.8.6

3 years ago

2.7.4

3 years ago

2.7.3

3 years ago

2.7.6

3 years ago

2.7.5

3 years ago

2.4.1

4 years ago

2.4.0

4 years ago

2.4.3

3 years ago

2.4.2

4 years ago

2.4.5

3 years ago

2.4.4

3 years ago

1.27.23

4 years ago

1.27.22

4 years ago

1.27.25

4 years ago

1.27.24

4 years ago

1.27.21

4 years ago

1.27.20

4 years ago

2.5.5

3 years ago

1.28.16

4 years ago

2.3.0

4 years ago

2.3.2

4 years ago

2.3.1

4 years ago

2.3.4

4 years ago

2.3.3

4 years ago

2.3.6

4 years ago

2.3.5

4 years ago

1.28.12

4 years ago

1.28.13

4 years ago

1.28.14

4 years ago

1.28.15

4 years ago

1.28.10

4 years ago

1.28.11

4 years ago

2.2.3

4 years ago

2.2.5

4 years ago

2.2.4

4 years ago

2.2.7

4 years ago

2.2.6

4 years ago

2.3.8

4 years ago

2.3.7

4 years ago

2.3.9

4 years ago

2.1.2

4 years ago

2.1.1

4 years ago

2.1.4

4 years ago

2.1.3

4 years ago

2.1.6

4 years ago

2.1.5

4 years ago

2.1.7

4 years ago

1.27.19

4 years ago

1.27.18

4 years ago

1.27.17

4 years ago

2.2.9

4 years ago

2.2.8

4 years ago

2.0.7

4 years ago

2.0.9

4 years ago

2.0.8

4 years ago

2.6.1

3 years ago

2.6.0

3 years ago

2.6.3

3 years ago

2.2.11

4 years ago

2.6.2

3 years ago

2.2.10

4 years ago

2.5.0

3 years ago

2.5.2

3 years ago

2.5.1

3 years ago

2.5.4

3 years ago

2.5.3

3 years ago

1.28.1

4 years ago

1.28.2

4 years ago

1.28.0

4 years ago

1.28.5

4 years ago

1.28.6

4 years ago

1.28.3

4 years ago

1.28.4

4 years ago

1.28.9

4 years ago

1.28.7

4 years ago

1.28.8

4 years ago

2.3.17

4 years ago

2.3.16

4 years ago

2.3.19

4 years ago

2.3.18

4 years ago

2.3.13

4 years ago

2.3.12

4 years ago

2.3.15

4 years ago

2.3.14

4 years ago

2.3.11

4 years ago

2.3.10

4 years ago

2.0.3

4 years ago

2.0.5

4 years ago

2.0.4

4 years ago

2.0.6

4 years ago

2.0.1

4 years ago

1.26.7

5 years ago

1.26.8

5 years ago

1.26.9

5 years ago

0.0.9

5 years ago

0.0.8

5 years ago

1.26.19

4 years ago

1.26.18

4 years ago

2.0.2-PR-1964-1

4 years ago

1.26.15

4 years ago

1.26.14

4 years ago

1.26.17

4 years ago

1.26.16

4 years ago

1.26.10

5 years ago

1.27.2

4 years ago

1.27.3

4 years ago

1.27.1

4 years ago

1.27.6

4 years ago

1.27.7

4 years ago

1.27.4

4 years ago

1.27.5

4 years ago

1.27.8

4 years ago

1.27.9

4 years ago

1.26.22

4 years ago

1.26.21

4 years ago

0.1.7

5 years ago

1.26.24

4 years ago

1.26.23

4 years ago

1.26.20

4 years ago

1.27.0-SNAPSHOT

4 years ago

1.27.16

4 years ago

1.27.15

4 years ago

0.2.1

5 years ago

0.2.0

5 years ago

1.27.12

4 years ago

0.2.7

5 years ago

1.27.11

4 years ago

0.2.6

5 years ago

1.27.13

4 years ago

0.2.3

5 years ago

0.2.2

5 years ago

1.27.10

4 years ago

0.2.5

5 years ago

0.2.4

5 years ago

0.1.4

5 years ago

0.1.3

5 years ago

0.1.6

5 years ago

0.1.5

5 years ago

0.1.2

5 years ago

0.1.0

5 years ago

0.1.1

5 years ago

0.0.60

5 years ago

0.0.59

5 years ago

0.0.58

5 years ago

0.0.57

5 years ago

0.0.56

5 years ago

0.0.55

5 years ago

1.24.1

5 years ago

1.23.8

5 years ago

1.24.0

5 years ago

1.23.7

5 years ago

1.23.6

5 years ago

1.23.5

5 years ago

1.23.4

5 years ago

1.23.3

5 years ago

1.23.2

5 years ago

1.23.0

5 years ago

1.23.1

5 years ago

1.22.3-1-6-2021

5 years ago

1.22.4

5 years ago

0.0.40

5 years ago

0.0.41

5 years ago

0.0.42

5 years ago

0.0.43

5 years ago

0.0.44

5 years ago

0.0.45

5 years ago

1.22.1-PR1470

5 years ago

0.0.38

5 years ago

0.0.39

5 years ago

1.21.10

5 years ago

1.21.11

5 years ago

1.21.12

5 years ago

1.22.0

5 years ago

1.22.3

5 years ago

1.22.1

5 years ago

1.22.2

5 years ago

1.22.0-PR1446-1

5 years ago

1.22.0-PR1446-2

5 years ago

1.22.0-PR1446-3

5 years ago

1.22.0-PR1446-4

5 years ago

1.22.0-PR1446-5

5 years ago

1.22.0-PR1446-6

5 years ago

1.22.0-PR1446-7

5 years ago

1.21.8

5 years ago

1.21.9

5 years ago

1.21.7

5 years ago

1.21.6

5 years ago

1.21.5

5 years ago

1.21.4

5 years ago

1.21.3

5 years ago

1.21.2

5 years ago

1.20.19

5 years ago

1.21.1

5 years ago

0.0.30

5 years ago

0.0.31

5 years ago

0.0.32

5 years ago

0.0.10

5 years ago

0.0.33

5 years ago

0.0.34

5 years ago

0.0.36

5 years ago

0.0.37

5 years ago

0.0.29

5 years ago

1.20.0

5 years ago

1.19.2

5 years ago