pulumi-digitalocean 4.27.0a1710332933__py3-none-any.whl → 4.39.0a1736833057__py3-none-any.whl

pulumi_digitalocean/cdn.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['CdnArgs', 'Cdn']
@@ -54,13 +59,11 @@ class CdnArgs:
 
     @property
     @pulumi.getter(name="certificateId")
+    @_utilities.deprecated("""Certificate IDs may change, for example when a Let's Encrypt certificate is auto-renewed. Please specify 'certificate_name' instead.""")
     def certificate_id(self) -> Optional[pulumi.Input[str]]:
         """
         **Deprecated** The ID of a DigitalOcean managed TLS certificate used for SSL when a custom subdomain is provided.
         """
-        warnings.warn("""Certificate IDs may change, for example when a Let's Encrypt certificate is auto-renewed. Please specify 'certificate_name' instead.""", DeprecationWarning)
-        pulumi.log.warn("""certificate_id is deprecated: Certificate IDs may change, for example when a Let's Encrypt certificate is auto-renewed. Please specify 'certificate_name' instead.""")
-
         return pulumi.get(self, "certificate_id")
 
     @certificate_id.setter
@@ -144,13 +147,11 @@ class _CdnState:
 
     @property
     @pulumi.getter(name="certificateId")
+    @_utilities.deprecated("""Certificate IDs may change, for example when a Let's Encrypt certificate is auto-renewed. Please specify 'certificate_name' instead.""")
     def certificate_id(self) -> Optional[pulumi.Input[str]]:
         """
         **Deprecated** The ID of a DigitalOcean managed TLS certificate used for SSL when a custom subdomain is provided.
         """
-        warnings.warn("""Certificate IDs may change, for example when a Let's Encrypt certificate is auto-renewed. Please specify 'certificate_name' instead.""", DeprecationWarning)
-        pulumi.log.warn("""certificate_id is deprecated: Certificate IDs may change, for example when a Let's Encrypt certificate is auto-renewed. Please specify 'certificate_name' instead.""")
-
         return pulumi.get(self, "certificate_id")
 
     @certificate_id.setter
@@ -248,35 +249,35 @@ class Cdn(pulumi.CustomResource):
 
         ### Basic Example
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         # Create a new Spaces Bucket
         mybucket = digitalocean.SpacesBucket("mybucket",
-            region="sfo2",
+            name="example",
+            region=digitalocean.Region.SFO2,
             acl="public-read")
         # Add a CDN endpoint to the Spaces Bucket
         mycdn = digitalocean.Cdn("mycdn", origin=mybucket.bucket_domain_name)
         pulumi.export("fqdn", mycdn.endpoint)
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Custom Sub-Domain Example
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         # Create a new Spaces Bucket
         mybucket = digitalocean.SpacesBucket("mybucket",
-            region="sfo2",
+            name="example",
+            region=digitalocean.Region.SFO2,
             acl="public-read")
         # Create a DigitalOcean managed Let's Encrypt Certificate
         cert = digitalocean.Certificate("cert",
-            type="lets_encrypt",
+            name="cdn-cert",
+            type=digitalocean.CertificateType.LETS_ENCRYPT,
             domains=["static.example.com"])
         # Add a CDN endpoint with a custom sub-domain to the Spaces Bucket
         mycdn = digitalocean.Cdn("mycdn",
@@ -284,7 +285,6 @@ class Cdn(pulumi.CustomResource):
             custom_domain="static.example.com",
             certificate_name=cert.name)
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 
@@ -315,35 +315,35 @@ class Cdn(pulumi.CustomResource):
 
         ### Basic Example
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         # Create a new Spaces Bucket
         mybucket = digitalocean.SpacesBucket("mybucket",
-            region="sfo2",
+            name="example",
+            region=digitalocean.Region.SFO2,
             acl="public-read")
         # Add a CDN endpoint to the Spaces Bucket
         mycdn = digitalocean.Cdn("mycdn", origin=mybucket.bucket_domain_name)
         pulumi.export("fqdn", mycdn.endpoint)
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Custom Sub-Domain Example
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         # Create a new Spaces Bucket
         mybucket = digitalocean.SpacesBucket("mybucket",
-            region="sfo2",
+            name="example",
+            region=digitalocean.Region.SFO2,
             acl="public-read")
         # Create a DigitalOcean managed Let's Encrypt Certificate
         cert = digitalocean.Certificate("cert",
-            type="lets_encrypt",
+            name="cdn-cert",
+            type=digitalocean.CertificateType.LETS_ENCRYPT,
             domains=["static.example.com"])
         # Add a CDN endpoint with a custom sub-domain to the Spaces Bucket
         mycdn = digitalocean.Cdn("mycdn",
@@ -351,7 +351,6 @@ class Cdn(pulumi.CustomResource):
             custom_domain="static.example.com",
             certificate_name=cert.name)
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 
@@ -446,13 +445,11 @@ class Cdn(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="certificateId")
+    @_utilities.deprecated("""Certificate IDs may change, for example when a Let's Encrypt certificate is auto-renewed. Please specify 'certificate_name' instead.""")
     def certificate_id(self) -> pulumi.Output[str]:
         """
         **Deprecated** The ID of a DigitalOcean managed TLS certificate used for SSL when a custom subdomain is provided.
         """
-        warnings.warn("""Certificate IDs may change, for example when a Let's Encrypt certificate is auto-renewed. Please specify 'certificate_name' instead.""", DeprecationWarning)
-        pulumi.log.warn("""certificate_id is deprecated: Certificate IDs may change, for example when a Let's Encrypt certificate is auto-renewed. Please specify 'certificate_name' instead.""")
-
         return pulumi.get(self, "certificate_id")
 
     @property

pulumi_digitalocean/certificate.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from ._enums import *
 
@@ -332,58 +337,57 @@ class Certificate(pulumi.CustomResource):
 
         ### Custom Certificate
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
+        import pulumi_std as std
 
         cert = digitalocean.Certificate("cert",
-            type="custom",
-            private_key=(lambda path: open(path).read())("/Users/myuser/certs/privkey.pem"),
-            leaf_certificate=(lambda path: open(path).read())("/Users/myuser/certs/cert.pem"),
-            certificate_chain=(lambda path: open(path).read())("/Users/myuser/certs/fullchain.pem"))
+            name="custom-example",
+            type=digitalocean.CertificateType.CUSTOM,
+            private_key=std.file(input="/Users/myuser/certs/privkey.pem").result,
+            leaf_certificate=std.file(input="/Users/myuser/certs/cert.pem").result,
+            certificate_chain=std.file(input="/Users/myuser/certs/fullchain.pem").result)
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Let's Encrypt Certificate
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         cert = digitalocean.Certificate("cert",
-            domains=["example.com"],
-            type="lets_encrypt")
+            name="le-example",
+            type=digitalocean.CertificateType.LETS_ENCRYPT,
+            domains=["example.com"])
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Use with Other Resources
 
         Both custom and Let's Encrypt certificates can be used with other resources
         including the `LoadBalancer` and `Cdn` resources.
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         cert = digitalocean.Certificate("cert",
-            type="lets_encrypt",
+            name="le-example",
+            type=digitalocean.CertificateType.LETS_ENCRYPT,
             domains=["example.com"])
         # Create a new Load Balancer with TLS termination
         public = digitalocean.LoadBalancer("public",
-            region="nyc3",
+            name="secure-loadbalancer-1",
+            region=digitalocean.Region.NYC3,
             droplet_tag="backend",
-            forwarding_rules=[digitalocean.LoadBalancerForwardingRuleArgs(
-                entry_port=443,
-                entry_protocol="https",
-                target_port=80,
-                target_protocol="http",
-                certificate_name=cert.name,
-            )])
+            forwarding_rules=[{
+                "entry_port": 443,
+                "entry_protocol": "https",
+                "target_port": 80,
+                "target_protocol": "http",
+                "certificate_name": cert.name,
+            }])
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 
@@ -427,58 +431,57 @@ class Certificate(pulumi.CustomResource):
 
         ### Custom Certificate
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
+        import pulumi_std as std
 
         cert = digitalocean.Certificate("cert",
-            type="custom",
-            private_key=(lambda path: open(path).read())("/Users/myuser/certs/privkey.pem"),
-            leaf_certificate=(lambda path: open(path).read())("/Users/myuser/certs/cert.pem"),
-            certificate_chain=(lambda path: open(path).read())("/Users/myuser/certs/fullchain.pem"))
+            name="custom-example",
+            type=digitalocean.CertificateType.CUSTOM,
+            private_key=std.file(input="/Users/myuser/certs/privkey.pem").result,
+            leaf_certificate=std.file(input="/Users/myuser/certs/cert.pem").result,
+            certificate_chain=std.file(input="/Users/myuser/certs/fullchain.pem").result)
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Let's Encrypt Certificate
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         cert = digitalocean.Certificate("cert",
-            domains=["example.com"],
-            type="lets_encrypt")
+            name="le-example",
+            type=digitalocean.CertificateType.LETS_ENCRYPT,
+            domains=["example.com"])
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Use with Other Resources
 
         Both custom and Let's Encrypt certificates can be used with other resources
         including the `LoadBalancer` and `Cdn` resources.
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         cert = digitalocean.Certificate("cert",
-            type="lets_encrypt",
+            name="le-example",
+            type=digitalocean.CertificateType.LETS_ENCRYPT,
             domains=["example.com"])
         # Create a new Load Balancer with TLS termination
         public = digitalocean.LoadBalancer("public",
-            region="nyc3",
+            name="secure-loadbalancer-1",
+            region=digitalocean.Region.NYC3,
             droplet_tag="backend",
-            forwarding_rules=[digitalocean.LoadBalancerForwardingRuleArgs(
-                entry_port=443,
-                entry_protocol="https",
-                target_port=80,
-                target_protocol="http",
-                certificate_name=cert.name,
-            )])
+            forwarding_rules=[{
+                "entry_port": 443,
+                "entry_protocol": "https",
+                "target_port": 80,
+                "target_protocol": "http",
+                "certificate_name": cert.name,
+            }])
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 

pulumi_digitalocean/config/__init__.pyi

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from .. import _utilities
 
 apiEndpoint: str

pulumi_digitalocean/config/vars.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from .. import _utilities
 
 import types

pulumi_digitalocean/container_registry.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['ContainerRegistryArgs', 'ContainerRegistry']
@@ -201,15 +206,15 @@ class ContainerRegistry(pulumi.CustomResource):
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         # Create a new container registry
-        foobar = digitalocean.ContainerRegistry("foobar", subscription_tier_slug="starter")
+        foobar = digitalocean.ContainerRegistry("foobar",
+            name="foobar",
+            subscription_tier_slug="starter")
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 
@@ -237,15 +242,15 @@ class ContainerRegistry(pulumi.CustomResource):
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         # Create a new container registry
-        foobar = digitalocean.ContainerRegistry("foobar", subscription_tier_slug="starter")
+        foobar = digitalocean.ContainerRegistry("foobar",
+            name="foobar",
+            subscription_tier_slug="starter")
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 

pulumi_digitalocean/container_registry_docker_credentials.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['ContainerRegistryDockerCredentialsArgs', 'ContainerRegistryDockerCredentials']
@@ -174,28 +179,46 @@ class ContainerRegistryDockerCredentials(pulumi.CustomResource):
 
         Get the container registry:
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         example = digitalocean.ContainerRegistryDockerCredentials("example", registry_name="example")
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Docker Provider Example
 
         Use the `endpoint` and `docker_credentials` with the Docker provider:
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
-        example_container_registry = digitalocean.get_container_registry(name="example")
-        example_container_registry_docker_credentials = digitalocean.ContainerRegistryDockerCredentials("exampleContainerRegistryDockerCredentials", registry_name="example")
+        example = digitalocean.get_container_registry(name="example")
+        example_container_registry_docker_credentials = digitalocean.ContainerRegistryDockerCredentials("example", registry_name="example")
+        ```
+
+        ### Kubernetes Example
+
+        Combined with the Kubernetes Provider's `kubernetes_secret` resource, you can
+        access the registry from inside your cluster:
+
+        ```python
+        import pulumi
+        import pulumi_digitalocean as digitalocean
+        import pulumi_kubernetes as kubernetes
+
+        example_container_registry_docker_credentials = digitalocean.ContainerRegistryDockerCredentials("example", registry_name="example")
+        example = digitalocean.get_kubernetes_cluster(name="prod-cluster-01")
+        example_secret = kubernetes.core.v1.Secret("example",
+            metadata={
+                "name": "docker-cfg",
+            },
+            data={
+                ".dockerconfigjson": example_container_registry_docker_credentials.docker_credentials,
+            },
+            type="kubernetes.io/dockerconfigjson")
         ```
-        <!--End PulumiCodeChooser -->
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -220,28 +243,46 @@ class ContainerRegistryDockerCredentials(pulumi.CustomResource):
 
         Get the container registry:
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         example = digitalocean.ContainerRegistryDockerCredentials("example", registry_name="example")
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Docker Provider Example
 
         Use the `endpoint` and `docker_credentials` with the Docker provider:
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
-        example_container_registry = digitalocean.get_container_registry(name="example")
-        example_container_registry_docker_credentials = digitalocean.ContainerRegistryDockerCredentials("exampleContainerRegistryDockerCredentials", registry_name="example")
+        example = digitalocean.get_container_registry(name="example")
+        example_container_registry_docker_credentials = digitalocean.ContainerRegistryDockerCredentials("example", registry_name="example")
+        ```
+
+        ### Kubernetes Example
+
+        Combined with the Kubernetes Provider's `kubernetes_secret` resource, you can
+        access the registry from inside your cluster:
+
+        ```python
+        import pulumi
+        import pulumi_digitalocean as digitalocean
+        import pulumi_kubernetes as kubernetes
+
+        example_container_registry_docker_credentials = digitalocean.ContainerRegistryDockerCredentials("example", registry_name="example")
+        example = digitalocean.get_kubernetes_cluster(name="prod-cluster-01")
+        example_secret = kubernetes.core.v1.Secret("example",
+            metadata={
+                "name": "docker-cfg",
+            },
+            data={
+                ".dockerconfigjson": example_container_registry_docker_credentials.docker_credentials,
+            },
+            type="kubernetes.io/dockerconfigjson")
         ```
-        <!--End PulumiCodeChooser -->
 
         :param str resource_name: The name of the resource.
         :param ContainerRegistryDockerCredentialsArgs args: The arguments to use to populate this resource's properties.

pulumi_digitalocean/custom_image.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['CustomImageArgs', 'CustomImage']
@@ -372,21 +377,21 @@ class CustomImage(pulumi.CustomResource):
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         flatcar = digitalocean.CustomImage("flatcar",
+            name="flatcar",
             url="https://stable.release.flatcar-linux.net/amd64-usr/2605.7.0/flatcar_production_digitalocean_image.bin.bz2",
             regions=["nyc3"])
         example = digitalocean.Droplet("example",
             image=flatcar.id,
-            region="nyc3",
-            size="s-1vcpu-1gb",
+            name="example-01",
+            region=digitalocean.Region.NYC3,
+            size=digitalocean.DropletSlug.DROPLET_S1_VCPU1_GB,
             ssh_keys=["12345"])
         ```
-        <!--End PulumiCodeChooser -->
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -418,21 +423,21 @@ class CustomImage(pulumi.CustomResource):
 
         ## Example Usage
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
         flatcar = digitalocean.CustomImage("flatcar",
+            name="flatcar",
             url="https://stable.release.flatcar-linux.net/amd64-usr/2605.7.0/flatcar_production_digitalocean_image.bin.bz2",
             regions=["nyc3"])
         example = digitalocean.Droplet("example",
             image=flatcar.id,
-            region="nyc3",
-            size="s-1vcpu-1gb",
+            name="example-01",
+            region=digitalocean.Region.NYC3,
+            size=digitalocean.DropletSlug.DROPLET_S1_VCPU1_GB,
             ssh_keys=["12345"])
         ```
-        <!--End PulumiCodeChooser -->
 
         :param str resource_name: The name of the resource.
         :param CustomImageArgs args: The arguments to use to populate this resource's properties.