[CodeDeploy] Added createDeployment() method (#1141)

* Added `createDeployment` method

* fix psalm

Co-authored-by: Jérémy Derussé <jeremy@derusse.com>

Author: martinssipenko

CHANGELOG.md

@@ -6,6 +6,7 @@
 
 - AWS api-change: Added `us-iso-west-1` region
 - AWS api-change: Use specific configuration for `us` regions
+- Added `createDeployment` method
 
 ## 1.2.1
 

src/CodeDeployClient.php

@@ -2,16 +2,46 @@
 
 namespace AsyncAws\CodeDeploy;
 
+use AsyncAws\CodeDeploy\Enum\FileExistsBehavior;
 use AsyncAws\CodeDeploy\Enum\LifecycleEventStatus;
+use AsyncAws\CodeDeploy\Exception\ApplicationDoesNotExistException;
+use AsyncAws\CodeDeploy\Exception\ApplicationNameRequiredException;
+use AsyncAws\CodeDeploy\Exception\DeploymentConfigDoesNotExistException;
 use AsyncAws\CodeDeploy\Exception\DeploymentDoesNotExistException;
+use AsyncAws\CodeDeploy\Exception\DeploymentGroupDoesNotExistException;
+use AsyncAws\CodeDeploy\Exception\DeploymentGroupNameRequiredException;
 use AsyncAws\CodeDeploy\Exception\DeploymentIdRequiredException;
+use AsyncAws\CodeDeploy\Exception\DeploymentLimitExceededException;
+use AsyncAws\CodeDeploy\Exception\DescriptionTooLongException;
+use AsyncAws\CodeDeploy\Exception\InvalidApplicationNameException;
+use AsyncAws\CodeDeploy\Exception\InvalidAutoRollbackConfigException;
+use AsyncAws\CodeDeploy\Exception\InvalidAutoScalingGroupException;
+use AsyncAws\CodeDeploy\Exception\InvalidDeploymentConfigNameException;
+use AsyncAws\CodeDeploy\Exception\InvalidDeploymentGroupNameException;
 use AsyncAws\CodeDeploy\Exception\InvalidDeploymentIdException;
+use AsyncAws\CodeDeploy\Exception\InvalidFileExistsBehaviorException;
+use AsyncAws\CodeDeploy\Exception\InvalidGitHubAccountTokenException;
+use AsyncAws\CodeDeploy\Exception\InvalidIgnoreApplicationStopFailuresValueException;
 use AsyncAws\CodeDeploy\Exception\InvalidLifecycleEventHookExecutionIdException;
 use AsyncAws\CodeDeploy\Exception\InvalidLifecycleEventHookExecutionStatusException;
+use AsyncAws\CodeDeploy\Exception\InvalidLoadBalancerInfoException;
+use AsyncAws\CodeDeploy\Exception\InvalidRevisionException;
+use AsyncAws\CodeDeploy\Exception\InvalidRoleException;
+use AsyncAws\CodeDeploy\Exception\InvalidTargetInstancesException;
+use AsyncAws\CodeDeploy\Exception\InvalidTrafficRoutingConfigurationException;
+use AsyncAws\CodeDeploy\Exception\InvalidUpdateOutdatedInstancesOnlyValueException;
 use AsyncAws\CodeDeploy\Exception\LifecycleEventAlreadyCompletedException;
+use AsyncAws\CodeDeploy\Exception\RevisionDoesNotExistException;
+use AsyncAws\CodeDeploy\Exception\RevisionRequiredException;
+use AsyncAws\CodeDeploy\Exception\ThrottlingException;
 use AsyncAws\CodeDeploy\Exception\UnsupportedActionForDeploymentTypeException;
+use AsyncAws\CodeDeploy\Input\CreateDeploymentInput;
 use AsyncAws\CodeDeploy\Input\PutLifecycleEventHookExecutionStatusInput;
+use AsyncAws\CodeDeploy\Result\CreateDeploymentOutput;
 use AsyncAws\CodeDeploy\Result\PutLifecycleEventHookExecutionStatusOutput;
+use AsyncAws\CodeDeploy\ValueObject\AutoRollbackConfiguration;
+use AsyncAws\CodeDeploy\ValueObject\RevisionLocation;
+use AsyncAws\CodeDeploy\ValueObject\TargetInstances;
 use AsyncAws\Core\AbstractApi;
 use AsyncAws\Core\AwsError\AwsErrorFactoryInterface;
 use AsyncAws\Core\AwsError\JsonRpcAwsErrorFactory;
@@ -20,6 +50,84 @@
 
 class CodeDeployClient extends AbstractApi
 {
+    /**
+     * Deploys an application revision through the specified deployment group.
+     *
+     * @see https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html
+     * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-codedeploy-2014-10-06.html#createdeployment
+     *
+     * @param array{
+     *   applicationName: string,
+     *   deploymentGroupName?: string,
+     *   revision?: RevisionLocation|array,
+     *   deploymentConfigName?: string,
+     *   description?: string,
+     *   ignoreApplicationStopFailures?: bool,
+     *   targetInstances?: TargetInstances|array,
+     *   autoRollbackConfiguration?: AutoRollbackConfiguration|array,
+     *   updateOutdatedInstancesOnly?: bool,
+     *   fileExistsBehavior?: FileExistsBehavior::*,
+     *   @region?: string,
+     * }|CreateDeploymentInput $input
+     *
+     * @throws ApplicationNameRequiredException
+     * @throws InvalidApplicationNameException
+     * @throws ApplicationDoesNotExistException
+     * @throws DeploymentGroupNameRequiredException
+     * @throws InvalidDeploymentGroupNameException
+     * @throws DeploymentGroupDoesNotExistException
+     * @throws RevisionRequiredException
+     * @throws RevisionDoesNotExistException
+     * @throws InvalidRevisionException
+     * @throws InvalidDeploymentConfigNameException
+     * @throws DeploymentConfigDoesNotExistException
+     * @throws DescriptionTooLongException
+     * @throws DeploymentLimitExceededException
+     * @throws InvalidTargetInstancesException
+     * @throws InvalidAutoRollbackConfigException
+     * @throws InvalidLoadBalancerInfoException
+     * @throws InvalidFileExistsBehaviorException
+     * @throws InvalidRoleException
+     * @throws InvalidAutoScalingGroupException
+     * @throws ThrottlingException
+     * @throws InvalidUpdateOutdatedInstancesOnlyValueException
+     * @throws InvalidIgnoreApplicationStopFailuresValueException
+     * @throws InvalidGitHubAccountTokenException
+     * @throws InvalidTrafficRoutingConfigurationException
+     */
+    public function createDeployment($input): CreateDeploymentOutput
+    {
+        $input = CreateDeploymentInput::create($input);
+        $response = $this->getResponse($input->request(), new RequestContext(['operation' => 'CreateDeployment', 'region' => $input->getRegion(), 'exceptionMapping' => [
+            'ApplicationNameRequiredException' => ApplicationNameRequiredException::class,
+            'InvalidApplicationNameException' => InvalidApplicationNameException::class,
+            'ApplicationDoesNotExistException' => ApplicationDoesNotExistException::class,
+            'DeploymentGroupNameRequiredException' => DeploymentGroupNameRequiredException::class,
+            'InvalidDeploymentGroupNameException' => InvalidDeploymentGroupNameException::class,
+            'DeploymentGroupDoesNotExistException' => DeploymentGroupDoesNotExistException::class,
+            'RevisionRequiredException' => RevisionRequiredException::class,
+            'RevisionDoesNotExistException' => RevisionDoesNotExistException::class,
+            'InvalidRevisionException' => InvalidRevisionException::class,
+            'InvalidDeploymentConfigNameException' => InvalidDeploymentConfigNameException::class,
+            'DeploymentConfigDoesNotExistException' => DeploymentConfigDoesNotExistException::class,
+            'DescriptionTooLongException' => DescriptionTooLongException::class,
+            'DeploymentLimitExceededException' => DeploymentLimitExceededException::class,
+            'InvalidTargetInstancesException' => InvalidTargetInstancesException::class,
+            'InvalidAutoRollbackConfigException' => InvalidAutoRollbackConfigException::class,
+            'InvalidLoadBalancerInfoException' => InvalidLoadBalancerInfoException::class,
+            'InvalidFileExistsBehaviorException' => InvalidFileExistsBehaviorException::class,
+            'InvalidRoleException' => InvalidRoleException::class,
+            'InvalidAutoScalingGroupException' => InvalidAutoScalingGroupException::class,
+            'ThrottlingException' => ThrottlingException::class,
+            'InvalidUpdateOutdatedInstancesOnlyValueException' => InvalidUpdateOutdatedInstancesOnlyValueException::class,
+            'InvalidIgnoreApplicationStopFailuresValueException' => InvalidIgnoreApplicationStopFailuresValueException::class,
+            'InvalidGitHubAccountTokenException' => InvalidGitHubAccountTokenException::class,
+            'InvalidTrafficRoutingConfigurationException' => InvalidTrafficRoutingConfigurationException::class,
+        ]]));
+
+        return new CreateDeploymentOutput($response);
+    }
+
     /**
      * Sets the result of a Lambda validation function. The function validates lifecycle hooks during a deployment that uses
      * the AWS Lambda or Amazon ECS compute platform. For AWS Lambda deployments, the available lifecycle hooks are

src/Enum/AutoRollbackEvent.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Enum;
+
+final class AutoRollbackEvent
+{
+    public const DEPLOYMENT_FAILURE = 'DEPLOYMENT_FAILURE';
+    public const DEPLOYMENT_STOP_ON_ALARM = 'DEPLOYMENT_STOP_ON_ALARM';
+    public const DEPLOYMENT_STOP_ON_REQUEST = 'DEPLOYMENT_STOP_ON_REQUEST';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::DEPLOYMENT_FAILURE => true,
+            self::DEPLOYMENT_STOP_ON_ALARM => true,
+            self::DEPLOYMENT_STOP_ON_REQUEST => true,
+        ][$value]);
+    }
+}

src/Enum/BundleType.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Enum;
+
+/**
+ * The file type of the application revision. Must be one of the following:.
+ *
+ * - `tar`: A tar archive file.
+ * - `tgz`: A compressed tar archive file.
+ * - `zip`: A zip archive file.
+ */
+final class BundleType
+{
+    public const JSON = 'JSON';
+    public const TAR = 'tar';
+    public const TGZ = 'tgz';
+    public const YAML = 'YAML';
+    public const ZIP = 'zip';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::JSON => true,
+            self::TAR => true,
+            self::TGZ => true,
+            self::YAML => true,
+            self::ZIP => true,
+        ][$value]);
+    }
+}

src/Enum/EC2TagFilterType.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Enum;
+
+/**
+ * The tag filter type:.
+ *
+ * - `KEY_ONLY`: Key only.
+ * - `VALUE_ONLY`: Value only.
+ * - `KEY_AND_VALUE`: Key and value.
+ */
+final class EC2TagFilterType
+{
+    public const KEY_AND_VALUE = 'KEY_AND_VALUE';
+    public const KEY_ONLY = 'KEY_ONLY';
+    public const VALUE_ONLY = 'VALUE_ONLY';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::KEY_AND_VALUE => true,
+            self::KEY_ONLY => true,
+            self::VALUE_ONLY => true,
+        ][$value]);
+    }
+}

src/Enum/FileExistsBehavior.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Enum;
+
+/**
+ * Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't
+ * part of the previous successful deployment.
+ * The `fileExistsBehavior` parameter takes any of the following values:.
+ *
+ * - DISALLOW: The deployment fails. This is also the default behavior if no option is specified.
+ * - OVERWRITE: The version of the file from the application revision currently being deployed replaces the version
+ *   already on the instance.
+ * - RETAIN: The version of the file already on the instance is kept and used as part of the new deployment.
+ */
+final class FileExistsBehavior
+{
+    public const DISALLOW = 'DISALLOW';
+    public const OVERWRITE = 'OVERWRITE';
+    public const RETAIN = 'RETAIN';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::DISALLOW => true,
+            self::OVERWRITE => true,
+            self::RETAIN => true,
+        ][$value]);
+    }
+}

src/Enum/RevisionLocationType.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Enum;
+
+/**
+ * The type of application revision:.
+ *
+ * - S3: An application revision stored in Amazon S3.
+ * - GitHub: An application revision stored in GitHub (EC2/On-premises deployments only).
+ * - String: A YAML-formatted or JSON-formatted string (AWS Lambda deployments only).
+ * - AppSpecContent: An `AppSpecContent` object that contains the contents of an AppSpec file for an AWS Lambda or
+ *   Amazon ECS deployment. The content is formatted as JSON or YAML stored as a RawString.
+ */
+final class RevisionLocationType
+{
+    public const APP_SPEC_CONTENT = 'AppSpecContent';
+    public const GIT_HUB = 'GitHub';
+    public const S3 = 'S3';
+    public const STRING = 'String';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::APP_SPEC_CONTENT => true,
+            self::GIT_HUB => true,
+            self::S3 => true,
+            self::STRING => true,
+        ][$value]);
+    }
+}

src/Exception/ApplicationDoesNotExistException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The application does not exist with the IAM user or AWS account.
+ */
+final class ApplicationDoesNotExistException extends ClientException
+{
+}

src/Exception/ApplicationNameRequiredException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The minimum number of required application names was not specified.
+ */
+final class ApplicationNameRequiredException extends ClientException
+{
+}

src/Exception/DeploymentConfigDoesNotExistException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The deployment configuration does not exist with the IAM user or AWS account.
+ */
+final class DeploymentConfigDoesNotExistException extends ClientException
+{
+}

src/Exception/DeploymentGroupDoesNotExistException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The named deployment group with the IAM user or AWS account does not exist.
+ */
+final class DeploymentGroupDoesNotExistException extends ClientException
+{
+}

src/Exception/DeploymentGroupNameRequiredException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The deployment group name was not specified.
+ */
+final class DeploymentGroupNameRequiredException extends ClientException
+{
+}

src/Exception/DeploymentLimitExceededException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The number of allowed deployments was exceeded.
+ */
+final class DeploymentLimitExceededException extends ClientException
+{
+}

src/Exception/DescriptionTooLongException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The description is too long.
+ */
+final class DescriptionTooLongException extends ClientException
+{
+}

src/Exception/InvalidApplicationNameException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The application name was specified in an invalid format.
+ */
+final class InvalidApplicationNameException extends ClientException
+{
+}

src/Exception/InvalidAutoRollbackConfigException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The automatic rollback configuration was specified in an invalid format. For example, automatic rollback is enabled,
+ * but an invalid triggering event type or no event types were listed.
+ */
+final class InvalidAutoRollbackConfigException extends ClientException
+{
+}