openstack_cli 0.13.5

// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// SPDX-License-Identifier: Apache-2.0

//! Placement v1 commands

use clap::{Parser, Subcommand};

use openstack_sdk::{AsyncOpenStack, types::ServiceType};

use crate::{Cli, OpenStackCliError};

pub mod allocation;
pub mod allocation_candidate;
pub mod reshaper;
pub mod resource_class;
pub mod resource_provider;
pub mod r#trait;
pub mod usage;

/// The placement API service was introduced in the 14.0.0 Newton release within the nova
/// repository and extracted to the placement repository in the 19.0.0 Stein release. This is a
/// REST API stack and data model used to track resource provider inventories and usages, along
/// with different classes of resources. For example, a resource provider can be a compute node, a
/// shared storage pool, or an IP allocation pool. The placement service tracks the inventory and
/// usage of each provider. For example, an instance created on a compute node may be a consumer of
/// resources such as RAM and CPU from a compute node resource provider, disk from an external
/// shared storage pool resource provider and IP addresses from an external IP pool resource
/// provider.
///
/// The types of resources consumed are tracked as classes. The service provides a set of standard
/// resource classes (for example DISK_GB, MEMORY_MB, and VCPU) and provides the ability to define
/// custom resource classes as needed.
///
/// Each resource provider may also have a set of traits which describe qualitative aspects of the
/// resource provider. Traits describe an aspect of a resource provider that cannot itself be
/// consumed but a workload may wish to specify. For example, available disk may be solid state
/// drives (SSD).
#[derive(Parser)]
pub struct PlacementCommand {
    /// Placement service resource
    #[command(subcommand)]
    command: PlacementCommands,
}

/// Supported subcommands
#[allow(missing_docs)]
#[derive(Subcommand)]
pub enum PlacementCommands {
    Allocation(Box<allocation::AllocationCommand>),
    AllocationCandidate(Box<allocation_candidate::AllocationCandidateCommand>),
    Reshaper(Box<reshaper::ReshaperCommand>),
    ResourceClass(Box<resource_class::ResourceClassCommand>),
    ResourceProvider(Box<resource_provider::ResourceProviderCommand>),
    Trait(Box<r#trait::TraitCommand>),
    Usage(Box<usage::UsageCommand>),
}

impl PlacementCommand {
    /// Perform command action
    pub async fn take_action(
        &self,
        parsed_args: &Cli,
        session: &mut AsyncOpenStack,
    ) -> Result<(), OpenStackCliError> {
        session
            .discover_service_endpoint(&ServiceType::Placement)
            .await?;

        match &self.command {
            PlacementCommands::Allocation(cmd) => cmd.take_action(parsed_args, session).await,
            PlacementCommands::AllocationCandidate(cmd) => {
                cmd.take_action(parsed_args, session).await
            }
            PlacementCommands::Reshaper(cmd) => cmd.take_action(parsed_args, session).await,
            PlacementCommands::ResourceClass(cmd) => cmd.take_action(parsed_args, session).await,
            PlacementCommands::ResourceProvider(cmd) => cmd.take_action(parsed_args, session).await,
            PlacementCommands::Trait(cmd) => cmd.take_action(parsed_args, session).await,
            PlacementCommands::Usage(cmd) => cmd.take_action(parsed_args, session).await,
        }
    }
}