This operation creates an api deployment for each specification file to an API Gateway for the OCI tenancy. The apiDeploy operation can only be used with a FlexDeploy package-based deployment project of type Oracle API Gateway. On deploy execution, file level attributes COMPARTMENT_NAME, GATEWAY_NAME, and PATH_PREFIX determine if the api deployment should be created new or update an existing deployment the content of the specification file. That means path prefix must be unique for the given compartment-gateway combination for a new api deployment to be created. Artifact is a single zip file containing api specification files (JSON or YAML).

Target Properties

Property Name	Property Code	Required	Description
Oracle API Gateway Account	`FDOAG_CLOUD_ACCOUNT_CODE`	No	OCI account with all the required properties like Tenancy Id, User OCID, and Private Key, etc. Oracle API Gateway Account will be required on either the plugin input or Target. If a value is set on both then, the plugin input will take precedence. See Special Considerations below for instructions on how to create an OCI account for Oracle API Gateway.
Compartment Name	`FDOAG_COMPARTMENT_NAME`	No	The OCI compartment to deploy an api to. Useful if you deploy to a different compartment per environment. Compartment Name is used and required if the Compartment Name on a file level attribute contains the value `$\{\{FDOAG_COMPARTMENT_NAME\}\}.</code></p></td></tr><tr><td class="confluenceTd"><p>Gateway Name</p></td><td class="confluenceTd"><p><code>FDOAG_GATEWAY_NAME</code></p></td><td class="confluenceTd"><p>No</p></td><td class="confluenceTd"><p>The OCI gateway to deploy an api to. Useful if you deploy to a different gateway per environment.</p><p>Gateway Name is used and required if Gateway Name on a file level attribute contains the value <code>$ {{FDOAG_GATEWAY_NAME}}`

Property Name

Property Code

Required

Description

Oracle API Gateway Account

FDOAG_CLOUD_ACCOUNT_CODE

OCI account with all the required properties like Tenancy Id, User OCID, and Private Key, etc.

Oracle API Gateway Account will be required on either the plugin input or Target. If a value is set on both then, the plugin input will take precedence.

See Special Considerations below for instructions on how to create an OCI account for Oracle API Gateway.

Compartment Name

FDOAG_COMPARTMENT_NAME

The OCI compartment to deploy an api to. Useful if you deploy to a different compartment per environment.

Compartment Name is used and required if the Compartment Name on a file level attribute contains the value $\{\{FDOAG_COMPARTMENT_NAME\}\}.</code></td></tr><tr><td class="confluenceTd">Gateway Name</td><td class="confluenceTd"><code>FDOAG_GATEWAY_NAME</code></td><td class="confluenceTd">No</td><td class="confluenceTd">The OCI gateway to deploy an api to. Useful if you deploy to a different gateway per environment.Gateway Name is used and required if Gateway Name on a file level attribute contains the value <code>$ {{FDOAG_GATEWAY_NAME}}

Project Properties

Property Name	Property Code	Required	Description
Root Compartment Id	`FDOAG_ROOT_COMPARTMENT_ID`	Yes	Root or parent compartment Id used to find the sub-compartments for api deployment. i.e. ocid1.tenancy.oc1..<OCID> This can be sub-compartment as well, but root is suggested.

Property Name

Property Code

Required

Description

Root Compartment Id

FDOAG_ROOT_COMPARTMENT_ID

Yes

Root or parent compartment Id used to find the sub-compartments for api deployment. i.e. ocid1.tenancy.oc1..<OCID>

This can be sub-compartment as well, but root is suggested.

Inputs

Input Name	Input Code	Required	Description
Oracle API Gateway Account	`FDOAG_INP_CLOUD_ACCOUNT_CODE`	No	OCI account with all the required properties like Tenancy Id, User OCID, and Private Key, etc.
Oracle API Gateway Replace List	`FDOAG_INP_REPLACE_LIST`	No	The String and Value to replace in files, formatted as key=value. One pair per line. Lines that begin with ’#’ will be ignored. This is useful if you wish to do property replacement on your artifact and don’t want to change the source code to contain property replacement syntax from the beginning. // The key on the left will be replaced with the value on the right dev-oic-vbcs-poc-idzor6zhmigm-ia.integration.ocp.oraclecloud.com:443= $\{\{OIC_SERVICE_URL\}\}$ {OrderService.url}=${{SOA_BASE_URL}}/soa-infra/services/defaults/OrderService/OrderService?WSDL
Add Tags	`FDOAG_INP_ADD_TAGS`	No	Add defined tags when an API is created or updated and when an APIDeployment is created or updated. This is used to linked SCM commits and FlexDeploy deploy events to API and APIDeployment creation or updates. Default is true. The following defined tags will be added on build: FlexDeploy.BRANCH i.e trunk, main, develop FlexDeploy.REVISION i.e. scm commit hash FlexDeploy.PROJECT_VERSION i.e. 1.0.1 FlexDeploy.EXEC_LINK i.e. http://host:port/flexdeploy/next/#/projects/<project_id>/execution/<execution_id>/summary If Add Tags is enabled, and these tags do not exist, FlexDeploy will automatically create the tag namespace (FlexDeploy) and the tags within it.

Input Name

Input Code

Required

Description

Oracle API Gateway Account

FDOAG_INP_CLOUD_ACCOUNT_CODE

OCI account with all the required properties like Tenancy Id, User OCID, and Private Key, etc.

Oracle API Gateway Replace List

FDOAG_INP_REPLACE_LIST

The String and Value to replace in files, formatted as key=value. One pair per line. Lines that begin with ’#’ will be ignored.

This is useful if you wish to do property replacement on your artifact and don’t want to change the source code to contain property replacement syntax from the beginning.

// The key on the left will be replaced with the value on the right
dev-oic-vbcs-poc-idzor6zhmigm-ia.integration.ocp.oraclecloud.com:443= $\{\{OIC_SERVICE_URL\}\}$ {OrderService.url}=${{SOA_BASE_URL}}/soa-infra/services/defaults/OrderService/OrderService?WSDL

Add Tags

FDOAG_INP_ADD_TAGS

Add defined tags when an API is created or updated and when an APIDeployment is created or updated. This is used to linked SCM commits and FlexDeploy deploy events to API and APIDeployment creation or updates. Default is true.

The following defined tags will be added on build:

FlexDeploy.BRANCH i.e trunk, main, develop
FlexDeploy.REVISION i.e. scm commit hash
FlexDeploy.PROJECT_VERSION i.e. 1.0.1
FlexDeploy.EXEC_LINK i.e. http://host:port/flexdeploy/next/#/projects/<project_id>/execution/<execution_id>/summary

If Add Tags is enabled, and these tags do not exist, FlexDeploy will automatically create the tag namespace (FlexDeploy) and the tags within it.

Artifacts

This operation consumes artifacts from the artifacts repository.

Endpoint Selection

This operation will select all available endpoints associated to the Target.

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

N/A

FlexDeploy 9.0 Documentation

​Target Properties

​Project Properties

​Inputs

​Artifacts

​Endpoint Selection

​Endpoint Execution

​Special Considerations

Target Properties

Project Properties

Inputs

Artifacts

Endpoint Selection

Endpoint Execution

Special Considerations