This operation installs a Gateway Node on endpoints configured with the resource 'Oracle API Platform Node Server' on the environment instance. The operation requires a gateway-props.json file for configuration. See the special considerations below for more information on the gateway-props.json file.
...
| Property Name | Property Code | Required | Description |
|---|---|---|---|
| Oracle API Platform Account | FDOAP_CLOUD_ACCOUNT_CODE | Y | The Oracle API Platform cloud account to use for this operation. |
| Oracle Gateway Install Home | FDOAP_GATEWAY_INSTALL_HOME | Y | Absolute location of where to install the gateway node configuration. This is where the executable and libraries will be located. This should be empty prior to running this operation. Note that this is different compared to the 'nodeInstallDir' property in the gateway-props.json |
| Node Weblogic User | FDOAP_NODE_WL_ADMIN_USER | Y | Weblogic admin user to configure when creating the node. Oracle API Platform Nodes are weblogic servers and this is your admin user. |
| Node Weblogic Password | FDOAP_NODE_WL_ADMIN_PASSWORD | Y | Weblogic admin password to configure when creating the node. |
Project Properties
| Property Name | Property Code | Required | Description
|---|
Inputs
| Input Name | Input Code | Required | Description |
|---|---|---|---|
| Gateway File | FDOAP_INP_GATEWAY_NODEPROPS_FILE | Y | Json node properties file to use for creation. Can be absolute path or relative to artifacts directory. See Special Considerations below for more information. |
| Copy Node Properties | FDOAP_INP_COPY_NODE_PROPS | N | If true, the 'Gateway File' input specified will be copied to the Node Install home. This will allow you to reuse this node properties file in other workflow steps, like 'executeNodeAction'. |
| Auto Approve Registration | FDOAP_INP_APPROVE_NODE_REG | N | By default, when a Node is installed a request is sent to the Logical Gateway for Approval to join the Logical Gateway. If this is true, the request will be auto approved. In order for this to work the Oracle API Platform user must have 'NodeServiceAccount' grant on the Gateway. This can be automatically added if using the 'ImportGateway' operation. |
| Install Action Override | FDOAP_INP_INSTALL_ACTION_OVERRIDE | N | By default, 'install-configure-start-join' is used when installing the Node. This means it expects the Logical Gateway to be existing ahead of time. You can override this to 'install-configure-start-create-join' which will create the Logical Gateway and Gateway Node in one shot. Depending on the action chosen, different or additional properties may be required in the Gateway File. |
...
| Property Key | Description | Required | Example Value | Recommendation |
|---|---|---|---|---|
| logicalGatewayId | Logical Gateway Id to join the Node to. Only required if using the default Node install action. | Sometimes | 117 | FlexDeploy property ${{FDOAP_GATEWAY_ID}}. |
| logicalGateway | Logical Gateway Name to create during installation. Only required when running 'install-configure-start-create-join' | Sometimes | Development | Either create your own FD property or some variation on FD_ENVIRONMENT_NAME |
| gatewayNodeName | The name of the Gateway Node to create. | Yes | Node MyDevServer | Node ${{FD_ENDPOINT_NAME}} |
| gatewayNodeDescription | The description you see when inspecting the node. | Yes | Created through FlexDeploy | Include ${{FD_PROJECT_VERSION}} somewhere |
| listenIpAddress | The internal IP used for configuration | Yes | yourinternalhost | Could potentially use ${{FD_ENDPOINT_ADDRESS}} |
| publishAddress | The public IP used for configuration | Yes | yourhost | Could potentially use ${{FD_ENDPOINT_ADDRESS}} |
| nodeInstallDir | Directory where to install the node. This is different than 'Oracle Gateway Install Home' above. | Yes | /opt/apiplatform/node | Keep this the same across Nodes for consistency. |
| gatewayExecutionMode | Development|Production. Development has certain networking security disabled. | Yes | Development | Create a user defined input |
...