deployAPI

Deploys an API to a Logical Gateway and any configured Nodes for that Gateway.  The API deployed is determined by the FDOAP_API_NAME and FDOAP_API_VERSION properties and the optional FDOAP_INP_API_ITERATION input.

This operation can also be used to undeploy, activate or inactivate a deployment depending on the Deploy Action input.

Environment/Instance Properties

Property NameProperty CodeRequiredDescription
Oracle API Platform AccountFDOAP_CLOUD_ACCOUNT_CODEYThe Oracle API Platform cloud account to use for this operation.  
Oracle API Gateway IdFDOAP_GATEWAY_IDYThe Logical Gateway Id to use for deployments.  This is found in the header drawer (3 vertical dots) when inspecting the Logical Gateway in API Platform.

Project Properties

Property NameProperty CodeRequiredDescription
Oracle API NameFDOAP_API_NAMEYName of the API being managed
Oracle API VersionFDOAP_API_VERSIONYVersion of the API being managed

Inputs

Input NameInput CodeRequiredDescription
Deploy ActionFDOAP_INP_DEPLOY_ACTIONYAction to use when deploying.  Valid choices are DEPLOY, UNDEPLOY, ACTIVATE, and INACTIVATE.  
API Runtime StateFDOAP_INP_API_STATEYThe runtime state of the API after deployment.  This only applies when the Deploy Action input is 'DEPLOY'.  Valid choices are ACTIVE and INACTIVE.
API StatusFDOAP_INP_API_STATUSNOptionally set the API status after deployment.  Valid choices are ALPHA, BETA, DEPRECATED, RELEASED, and RETIRED
Deployment DescriptionFDOAP_INP_DESCRIPTIONNDescription for the deployment request.  This shows up in the API deployments section under the Logical Gateway name.  
API IterationFDOAP_INP_API_ITERATIONNOptional API Iteration to deploy.  If this is left blank then the current iteration on the API Platform server will be deployed.
Deploy Wait DurationFDOAP_INP_WAIT_DURATIONNTime to wait (in milliseconds) for the deploy request to complete.  The deploy request is submitted immediately and then monitored for success for this duration.  If time runs out before it succeeds the request will not fail but rather gracefully end with a warning. 

Artifacts

This operation consumes artifacts from the artifacts repository.


Endpoint Selection

This operation will select all available endpoints associated to the environment/instance.


Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.


Special Considerations

How to deploy a specific API Iteration

If you want to deploy a specific API Iteration, which I recommend you do, then you have two options:

  1. If your deploy workflow is not running the ImportAPI step then I recommend you save the output API Iteration from ExportAPI to a file during the build workflow.  You can then read that file in during deploy.  Check out these build/deploy workflows:
    1. Build Workflow
    2. Deploy Workflow
  2. If you deploy workflow does have the import step prior to deployment then you can simply use the output returned from that step.
    1. Build Workflow
    2. Deploy Workflow

Settings the API Status Input

Try setting this based on the FD_ENVIRONMENT_CODE.  Switch it to an expression and use something like the following:

if (FD_ENVIRONMENT_CODE.equals('TEST')){
  'ALPHA'
}
else if (FD_ENVIRONMENT_CODE.equals('PROD')){
  'RELEASED'
}
else 'BETA'

Finding the Gateway Id environment instance property

The following macros are not currently supported in the footer:
  • style