Oracle Cloud Infrastructure Documentation

Creating a Fleet

Group resources dynamically or manually to create a fleet in Fleet Application Management.

Creating a fleet helps you group resources based on similarity or defined criteria. Grouping resources can help you view all resources within a tenancy on a single page and find detailed information about a resource  or group.

In previous releases, Fleet Application Management supported four distinct types of fleets. From now on, all fleets are classified as generic. However, you can still characterize fleets by Product, Environment, and Group using the following methods:

To make the previous three fleet types (Product, Environment, and Group) relatable to the generic fleet, the following mappings can be used:
  • Product: When creating a fleet, you can associate it with a specific product or product stack. See 2. (Optional) Select product/product stacks
  • Environment: Enter the environment details when creating a fleet. See 1. Basic information.
  • Group: To establish a hierarchical structure, use parent-child associations during fleet creation. For example, you can create a nonproduction fleet (as the parent) by combining existing fleets from development, testing, and staging environments (the child fleets). This method allows you to perform lifecycle operations on all child fleets before transitioning them to the production fleet. See 1. Basic information and Child Fleets in Fleet Application Management.

  • On the Fleets list page, select Create fleet. If you need help finding the list page, see Listing Fleets.

    Creating a fleet consists of the following pages:

    Run each of the following workflows in order. You can return to a previous page by selecting Previous.

    1. Basic information

    The Basic information page is where you provide the basic information for a fleet in Fleet Application Management.

    Enter the following information:

    • Name: Enter a friendly name for the fleet. The name doesn't have to be unique, but it can't be changed in the Console. You can, however, change it with the API. Avoid entering confidential information.
    • Description: Enter a suitable description for the fleet.
    • Create in compartment: Select the compartment that you want to store the fleet in.
    • Environment Compartment: Select the compartment where a specific environment type exists. For the list of environment types, see environment types.
    • Environment: Select an environment type for the fleet—for example, development, production, stage, test, or custom.
    • Create as a child fleet: Switch on the toggle if this fleet is a child of another fleet.
    • Parent fleet Compartment: Select the compartment where the parent fleet exists.
    • Parent fleet: Select a fleet that can be a parent to this fleet. After you select a parent fleet, the association with the parent fleet is created and this fleet automatically becomes a child fleet under the parent fleet.

    All the following sections and steps in the workflow are optional, and you can create a fleet by providing only the basic information and configuring these optional workflow steps later.

    By supplying the basic information, you can create an empty fleet. Use this empty fleet as a foundation for infrastructure provisioning and continue with the run operation and maintenance of resources.

    (Optional) Add resources or add rules
    Note

    When a resource is part of the fleet, Fleet Application Management automatically activates and starts the Fleet Application Management plugin, which is used for runbook executions. A managed resource is a resource that's part of the fleet. Likewise, when no resources are managed by Fleet Application Management, the Fleet Application Management plugin is automatically stopped and disabled.
    Select one of the following options:
    • Manual selection: Filter and add resources manually.

      Select Add resources and then enter details in the Add resources panel. For instructions, see steps 3 to 7 in Adding Resources to a Fleet Manually using the Console.

      The resources that you select, their resource types and compartment appear under Add resources.

    • Dynamic resources: Group resources dynamically based on rules that match.

      For instructions, see steps 4 to 8 in Adding Resources to a Fleet Dynamically using the Console.

    (Optional) Fleet credentials

    Select Add fleet credential. Then, enter details in the Add credentials for fleet page.

    For instructions, see steps 5 to 10 in Adding a Credential using the Console.

    (Optional) Properties
    Associate the business-specific metadata property with the fleet and enable automatic confirmation of resource targets. See Properties in Fleet Application Management for more information on properties.
    1. To add an existing property to the fleet, select the compartment that contains the property, the property name, and the corresponding value.
      Add more properties as needed.
    2. (Optional) To automatically confirm target resources after fleet discovery, switch on the Enable auto confirm of targets toggle. By default, this option is turned on for a fleet.
      Note

      If discovery fails and a system error occurs, you can manually confirm the targets after discovery. See Confirming Targets.
    (Optional) Tags

    In the Tags section, add one or more tags to the fleet. If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.

    Select Next to proceed to the next step.

    2. (Optional) Select product/product stacks

    You associate the product or product stack with the fleet in this page.

    Select Add product/product stack to open the Add product panel. In the product list table, select the checkbox next to the products to use for the fleet from a specific compartment, for example, Oracle WebLogic Server or Oracle Exadata OS. Then, select Add.

    Note

    If you need help finding the product, see Listing Products.

    The products that you select, their types, and compartment appear in the Select products/product stack to manage list table. To remove an item from the list table, select the checkbox next to the product or product stack name, and then select Remove.

    Select Next to proceed to the next step.

    3. (Optional) Notification

    The Notification page is where you select the topics that have been configured in the OCI Notifications service.

    1. To get notified when the fleet status changes, select Create new notification and then add the following information:
      • Compartment: Select the compartment that contains the notification topic.
      • Topic: Select a topic (Notifications)  that you created in the Notifications service. For information about managing Notifications topics, see Managing Topics.
      • Notification preferences: Select when you want to be notified about a change. For example, with the upcoming schedule, when a new version of runbook is available, when the environment type for a fleet is changed, and so on.
    2. Select Add.

      The notification topics that you select, their preferences, and compartment appear in the Notification list table.

    3. To remove an item from the list table, select the checkbox next to the notification, and then select Remove.

    Select Next to proceed to the next step.

    4. Review

    Review the contents of the Review page. Edit settings or return to previous screens to add information. When the fleet settings are fully verified, select Create to create a fleet and list it on the Fleets list page.

  • Use the oci fleet-apps-management fleet create command and required parameters to create a fleet:

    oci fleet-apps-management fleet create --compartment-id <compartment_OCID> --display-name <text> --resource-selection <json_file_or_string> [OPTIONS]

    For a complete list of flags and variable options for Fleet Application Management CLI commands, see the CLI for Fleet Application Management.

  • Run the CreateFleet operation to create a fleet.