Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

A plugin for managing APIs and other components in Oracle API Platform.

...

API ComponentBuild WorkflowDeploy WorkflowProject SetupGeneral Notes
API

Export flexApi.json from source control

Save ArtifactsExportAPI

ImportAPI (using smart import)

DeployAPI

Ideally your flexApi.json is bundled along with

your implementation and everything is built/deployed 

in one project.

  • Just copy the flexApi.json between projects
  • Change key fields, name, endpoint etc.  (Could even use FD variables)

    (use the output iteration from the import step)

    One project per API.

    • Group in a release along with whatever back end code is needed.
    • Recommend saving the API iterations as workflow outputs for visibility. 
    • Use a groovy expression to update the API status on Deployment based on the FD_ENVIRONMENT_CODE
    Gateway/NodesExport gateway and node json files

    ImportGateway

    InstallNode

    Nothing real specific here.  One project that manages 

    all the gateways/nodes should suffice. 

    • Json configuration files for the nodes and gateways should utilize FD variables for environment specifics
    • Default behavior for installNode joins it to an existing logical server (this can be overridden).

    ...

    Info
    titleCloud Account

    All plugin operations require the FDOAP_CLOUD_ACCOUNT_CODE environment instance property to be set.  See Configuring Cloud Accounts for more info.  The following properties are required for the Oracle API Platform Cloud Account

    Property NameProperty CodeRequiredDescription
    Oracle API Platform UrlFDOAP_API_URLYBase Url for the API Platform
    Oracle Identity UrlFDOAP_IDENTITY_URLYBase Url for Oracle Identity
    Oracle API UsernameFDOAP_USERNAMEYUsername for authentication
    Oracle API PasswordFDOAP_PASSWORDYPassword for authentication
    Oracle API AudienceFDOAP_AUDIENCEYPrimary Audience for the API Platform
    Oracle API ScopeFDOAP_SCOPEYScope for making API calls
    Oracle API Client IdFDOAP_CLIENT_IDYClient Id for the API Platform Application
    Oracle API Client SecretFDOAP_CLIENT_SECRETYClient Secret for the API Platform Application


    ...