docs(secretmanager): Added sample for creating Secret with UserManaged replication (GoogleCloudPlatform#1664)

Author: kapishps

secretmanager/src/create_secret_with_user_managed_replication.php

@@ -0,0 +1,70 @@
+<?php
+/*
+ * Copyright 2022 Google LLC.
+ *
+ * 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.
+ */
+
+/*
+ * For instructions on how to run the full sample:
+ *
+ * @see https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/secretmanager/README.md
+ */
+
+declare(strict_types=1);
+
+namespace Google\Cloud\Samples\SecretManager;
+
+// Import the Secret Manager client library.
+use Google\Cloud\SecretManager\V1\Replication;
+use Google\Cloud\SecretManager\V1\Replication\UserManaged;
+use Google\Cloud\SecretManager\V1\Replication\UserManaged\Replica;
+use Google\Cloud\SecretManager\V1\Secret;
+use Google\Cloud\SecretManager\V1\SecretManagerServiceClient;
+
+/**
+ * @param string $projectId Your Google Cloud Project ID (e.g. 'my-project')
+ * @param string $secretId  Your secret ID (e.g. 'my-secret')
+ * @param array  $locations Replication locations (e.g. array('us-east1', 'us-east4'))
+ */
+function create_secret_with_user_managed_replication(string $projectId, string $secretId, array $locations): void
+{
+    // Create the Secret Manager client.
+    $client = new SecretManagerServiceClient();
+
+    // Build the resource name of the parent project.
+    $parent = $client->projectName($projectId);
+
+    $replicas = [];
+    foreach ($locations as $location) {
+        $replicas[] = new Replica(['location' => $location]);
+    }
+
+    $secret = new Secret([
+        'replication' => new Replication([
+            'user_managed' => new UserManaged([
+                'replicas' => $replicas
+            ]),
+        ]),
+    ]);
+
+    // Create the secret.
+    $secret = $client->createSecret($parent, $secretId, $secret);
+
+    // Print the new secret name.
+    printf('Created secret: %s', $secret->getName());
+}
+
+// The following 2 lines are only needed to execute the samples on the CLI
+require_once __DIR__ . '/../../testing/sample_helpers.php';
+\Google\Cloud\Samples\execute_sample(__FILE__, __NAMESPACE__, $argv);

secretmanager/test/secretmanagerTest.php

@@ -38,6 +38,7 @@ class secretmanagerTest extends TestCase
     private static $testSecretToDelete;
     private static $testSecretWithVersions;
     private static $testSecretToCreateName;
+    private static $testUmmrSecretToCreateName;
     private static $testSecretVersion;
     private static $testSecretVersionToDestroy;
     private static $testSecretVersionToDisable;
@@ -53,6 +54,7 @@ public static function setUpBeforeClass(): void
         self::$testSecretToDelete = self::createSecret();
         self::$testSecretWithVersions = self::createSecret();
         self::$testSecretToCreateName = self::$client->secretName(self::$projectId, self::randomSecretId());
+        self::$testUmmrSecretToCreateName = self::$client->secretName(self::$projectId, self::randomSecretId());
 
         self::$testSecretVersion = self::addSecretVersion(self::$testSecretWithVersions);
         self::$testSecretVersionToDestroy = self::addSecretVersion(self::$testSecretWithVersions);
@@ -67,6 +69,7 @@ public static function tearDownAfterClass(): void
         self::deleteSecret(self::$testSecretToDelete->getName());
         self::deleteSecret(self::$testSecretWithVersions->getName());
         self::deleteSecret(self::$testSecretToCreateName);
+        self::deleteSecret(self::$testUmmrSecretToCreateName);
     }
 
     private static function randomSecretId(): string
@@ -148,6 +151,19 @@ public function testCreateSecret()
         $this->assertStringContainsString('Created secret', $output);
     }
 
+    public function testCreateSecretWithUserManagedReplication()
+    {
+        $name = self::$client->parseName(self::$testUmmrSecretToCreateName);
+
+        $output = $this->runFunctionSnippet('create_secret_with_user_managed_replication', [
+            $name['project'],
+            $name['secret'],
+            'us-east1,us-east4,us-west1',
+        ]);
+
+        $this->assertStringContainsString('Created secret', $output);
+    }
+
     public function testDeleteSecret()
     {
         $name = self::$client->parseName(self::$testSecretToDelete->getName());