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

pulumi_digitalocean/_utilities.py

@@ -4,6 +4,7 @@
 
 
 import asyncio
+import functools
 import importlib.metadata
 import importlib.util
 import inspect
@@ -11,14 +12,19 @@ import json
 import os
 import sys
 import typing
+import warnings
+import base64
 
 import pulumi
 import pulumi.runtime
 from pulumi.runtime.sync_await import _sync_await
+from pulumi.runtime.proto import resource_pb2
 
 from semver import VersionInfo as SemverVersion
 from parver import Version as PEP440Version
 
+C = typing.TypeVar("C", bound=typing.Callable)
+
 
 def get_env(*args):
     for v in args:
@@ -96,10 +102,6 @@ def _get_semver_version():
 _version = _get_semver_version()
 _version_str = str(_version)
 
-
-def get_version():
-    return _version_str
-
 def get_resource_opts_defaults() -> pulumi.ResourceOptions:
     return pulumi.ResourceOptions(
         version=get_version(),
@@ -262,7 +264,7 @@ def call_plain(
     output = pulumi.runtime.call(tok, props, res, typ)
 
     # Ingoring deps silently. They are typically non-empty, r.f() calls include r as a dependency.
-    result, known, secret, _ = _sync_await(asyncio.ensure_future(_await_output(output)))
+    result, known, secret, _ = _sync_await(asyncio.create_task(_await_output(output)))
 
     problem = None
     if not known:
@@ -287,5 +289,39 @@ async def _await_output(o: pulumi.Output[typing.Any]) -> typing.Tuple[object, bo
         await o._resources,
     )
 
+
+# This is included to provide an upgrade path for users who are using a version
+# of the Pulumi SDK (<3.121.0) that does not include the `deprecated` decorator.
+def deprecated(message: str) -> typing.Callable[[C], C]:
+    """
+    Decorator to indicate a function is deprecated.
+
+    As well as inserting appropriate statements to indicate that the function is
+    deprecated, this decorator also tags the function with a special attribute
+    so that Pulumi code can detect that it is deprecated and react appropriately
+    in certain situations.
+
+    message is the deprecation message that should be printed if the function is called.
+    """
+
+    def decorator(fn: C) -> C:
+        if not callable(fn):
+            raise TypeError("Expected fn to be callable")
+
+        @functools.wraps(fn)
+        def deprecated_fn(*args, **kwargs):
+            warnings.warn(message)
+            pulumi.warn(f"{fn.__name__} is deprecated: {message}")
+
+            return fn(*args, **kwargs)
+
+        deprecated_fn.__dict__["_pulumi_deprecated_callable"] = fn
+        return typing.cast(C, deprecated_fn)
+
+    return decorator
+
 def get_plugin_download_url():
 	return None
+
+def get_version():
+     return _version_str

pulumi_digitalocean/app.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 . import outputs
 from ._inputs import *
@@ -16,10 +21,12 @@ __all__ = ['AppArgs', 'App']
 @pulumi.input_type
 class AppArgs:
     def __init__(__self__, *,
+                 dedicated_ips: Optional[pulumi.Input[Sequence[pulumi.Input['AppDedicatedIpArgs']]]] = None,
                  project_id: Optional[pulumi.Input[str]] = None,
                  spec: Optional[pulumi.Input['AppSpecArgs']] = None):
         """
         The set of arguments for constructing a App resource.
+        :param pulumi.Input[Sequence[pulumi.Input['AppDedicatedIpArgs']]] dedicated_ips: The dedicated egress IP addresses associated with the app.
         :param pulumi.Input[str] project_id: The ID of the project that the app is assigned to.
                
                A spec can contain multiple components.
@@ -27,11 +34,25 @@ class AppArgs:
                A `service` can contain:
         :param pulumi.Input['AppSpecArgs'] spec: A DigitalOcean App spec describing the app.
         """
+        if dedicated_ips is not None:
+            pulumi.set(__self__, "dedicated_ips", dedicated_ips)
         if project_id is not None:
             pulumi.set(__self__, "project_id", project_id)
         if spec is not None:
             pulumi.set(__self__, "spec", spec)
 
+    @property
+    @pulumi.getter(name="dedicatedIps")
+    def dedicated_ips(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['AppDedicatedIpArgs']]]]:
+        """
+        The dedicated egress IP addresses associated with the app.
+        """
+        return pulumi.get(self, "dedicated_ips")
+
+    @dedicated_ips.setter
+    def dedicated_ips(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['AppDedicatedIpArgs']]]]):
+        pulumi.set(self, "dedicated_ips", value)
+
     @property
     @pulumi.getter(name="projectId")
     def project_id(self) -> Optional[pulumi.Input[str]]:
@@ -67,7 +88,9 @@ class _AppState:
                  active_deployment_id: Optional[pulumi.Input[str]] = None,
                  app_urn: Optional[pulumi.Input[str]] = None,
                  created_at: Optional[pulumi.Input[str]] = None,
+                 dedicated_ips: Optional[pulumi.Input[Sequence[pulumi.Input['AppDedicatedIpArgs']]]] = None,
                  default_ingress: Optional[pulumi.Input[str]] = None,
+                 live_domain: Optional[pulumi.Input[str]] = None,
                  live_url: Optional[pulumi.Input[str]] = None,
                  project_id: Optional[pulumi.Input[str]] = None,
                  spec: Optional[pulumi.Input['AppSpecArgs']] = None,
@@ -77,7 +100,9 @@ class _AppState:
         :param pulumi.Input[str] active_deployment_id: The ID the app's currently active deployment.
         :param pulumi.Input[str] app_urn: The uniform resource identifier for the app.
         :param pulumi.Input[str] created_at: The date and time of when the app was created.
+        :param pulumi.Input[Sequence[pulumi.Input['AppDedicatedIpArgs']]] dedicated_ips: The dedicated egress IP addresses associated with the app.
         :param pulumi.Input[str] default_ingress: The default URL to access the app.
+        :param pulumi.Input[str] live_domain: The live domain of the app.
         :param pulumi.Input[str] live_url: The live URL of the app.
         :param pulumi.Input[str] project_id: The ID of the project that the app is assigned to.
                
@@ -93,8 +118,12 @@ class _AppState:
             pulumi.set(__self__, "app_urn", app_urn)
         if created_at is not None:
             pulumi.set(__self__, "created_at", created_at)
+        if dedicated_ips is not None:
+            pulumi.set(__self__, "dedicated_ips", dedicated_ips)
         if default_ingress is not None:
             pulumi.set(__self__, "default_ingress", default_ingress)
+        if live_domain is not None:
+            pulumi.set(__self__, "live_domain", live_domain)
         if live_url is not None:
             pulumi.set(__self__, "live_url", live_url)
         if project_id is not None:
@@ -140,6 +169,18 @@ class _AppState:
     def created_at(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "created_at", value)
 
+    @property
+    @pulumi.getter(name="dedicatedIps")
+    def dedicated_ips(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['AppDedicatedIpArgs']]]]:
+        """
+        The dedicated egress IP addresses associated with the app.
+        """
+        return pulumi.get(self, "dedicated_ips")
+
+    @dedicated_ips.setter
+    def dedicated_ips(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['AppDedicatedIpArgs']]]]):
+        pulumi.set(self, "dedicated_ips", value)
+
     @property
     @pulumi.getter(name="defaultIngress")
     def default_ingress(self) -> Optional[pulumi.Input[str]]:
@@ -152,6 +193,18 @@ class _AppState:
     def default_ingress(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "default_ingress", value)
 
+    @property
+    @pulumi.getter(name="liveDomain")
+    def live_domain(self) -> Optional[pulumi.Input[str]]:
+        """
+        The live domain of the app.
+        """
+        return pulumi.get(self, "live_domain")
+
+    @live_domain.setter
+    def live_domain(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "live_domain", value)
+
     @property
     @pulumi.getter(name="liveUrl")
     def live_url(self) -> Optional[pulumi.Input[str]]:
@@ -210,8 +263,9 @@ class App(pulumi.CustomResource):
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
+                 dedicated_ips: Optional[pulumi.Input[Sequence[pulumi.Input[Union['AppDedicatedIpArgs', 'AppDedicatedIpArgsDict']]]]] = None,
                  project_id: Optional[pulumi.Input[str]] = None,
-                 spec: Optional[pulumi.Input[pulumi.InputType['AppSpecArgs']]] = None,
+                 spec: Optional[pulumi.Input[Union['AppSpecArgs', 'AppSpecArgsDict']]] = None,
                  __props__=None):
         """
         Provides a DigitalOcean App resource.
@@ -222,50 +276,76 @@ class App(pulumi.CustomResource):
 
         ### Basic Example
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
-        golang_sample = digitalocean.App("golang-sample", spec=digitalocean.AppSpecArgs(
-            name="golang-sample",
-            region="ams",
-            services=[digitalocean.AppSpecServiceArgs(
-                environment_slug="go",
-                git=digitalocean.AppSpecServiceGitArgs(
-                    branch="main",
-                    repo_clone_url="https://github.com/digitalocean/sample-golang.git",
-                ),
-                instance_count=1,
-                instance_size_slug="professional-xs",
-                name="go-service",
-            )],
-        ))
+        golang_sample = digitalocean.App("golang-sample", spec={
+            "name": "golang-sample",
+            "region": "ams",
+            "services": [{
+                "name": "go-service",
+                "instance_count": 1,
+                "instance_size_slug": "apps-s-1vcpu-1gb",
+                "git": {
+                    "repo_clone_url": "https://github.com/digitalocean/sample-golang.git",
+                    "branch": "main",
+                },
+            }],
+        })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Static Site Example
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
-        static_site_example = digitalocean.App("static-site-example", spec=digitalocean.AppSpecArgs(
-            name="static-site-example",
-            region="ams",
-            static_sites=[digitalocean.AppSpecStaticSiteArgs(
-                build_command="bundle exec jekyll build -d ./public",
-                git=digitalocean.AppSpecStaticSiteGitArgs(
-                    branch="main",
-                    repo_clone_url="https://github.com/digitalocean/sample-jekyll.git",
-                ),
-                name="sample-jekyll",
-                output_dir="/public",
-            )],
-        ))
+        static_site_example = digitalocean.App("static-site-example", spec={
+            "name": "static-site-example",
+            "region": "ams",
+            "static_sites": [{
+                "name": "sample-jekyll",
+                "build_command": "bundle exec jekyll build -d ./public",
+                "output_dir": "/public",
+                "git": {
+                    "repo_clone_url": "https://github.com/digitalocean/sample-jekyll.git",
+                    "branch": "main",
+                },
+            }],
+        })
+        ```
+
+        ### Log Destination Example with Opensearch
+
+        ```python
+        import pulumi
+        import pulumi_digitalocean as digitalocean
+
+        golang_sample = digitalocean.App("golang-sample", spec={
+            "name": "golang-sample",
+            "region": "ams",
+            "services": [{
+                "name": "go-service",
+                "instance_count": 1,
+                "instance_size_slug": "apps-s-1vcpu-1gb",
+                "git": {
+                    "repo_clone_url": "https://github.com/digitalocean/sample-golang.git",
+                    "branch": "main",
+                },
+                "log_destinations": [{
+                    "name": "MyLogs",
+                    "open_search": {
+                        "endpoint": "https://something:1234",
+                        "basic_auth": {
+                            "user": "user",
+                            "password": "hi",
+                        },
+                    },
+                }],
+            }],
+        })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 
@@ -277,12 +357,13 @@ class App(pulumi.CustomResource):
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['AppDedicatedIpArgs', 'AppDedicatedIpArgsDict']]]] dedicated_ips: The dedicated egress IP addresses associated with the app.
         :param pulumi.Input[str] project_id: The ID of the project that the app is assigned to.
                
                A spec can contain multiple components.
                
                A `service` can contain:
-        :param pulumi.Input[pulumi.InputType['AppSpecArgs']] spec: A DigitalOcean App spec describing the app.
+        :param pulumi.Input[Union['AppSpecArgs', 'AppSpecArgsDict']] spec: A DigitalOcean App spec describing the app.
         """
         ...
     @overload
@@ -299,50 +380,76 @@ class App(pulumi.CustomResource):
 
         ### Basic Example
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
-        golang_sample = digitalocean.App("golang-sample", spec=digitalocean.AppSpecArgs(
-            name="golang-sample",
-            region="ams",
-            services=[digitalocean.AppSpecServiceArgs(
-                environment_slug="go",
-                git=digitalocean.AppSpecServiceGitArgs(
-                    branch="main",
-                    repo_clone_url="https://github.com/digitalocean/sample-golang.git",
-                ),
-                instance_count=1,
-                instance_size_slug="professional-xs",
-                name="go-service",
-            )],
-        ))
+        golang_sample = digitalocean.App("golang-sample", spec={
+            "name": "golang-sample",
+            "region": "ams",
+            "services": [{
+                "name": "go-service",
+                "instance_count": 1,
+                "instance_size_slug": "apps-s-1vcpu-1gb",
+                "git": {
+                    "repo_clone_url": "https://github.com/digitalocean/sample-golang.git",
+                    "branch": "main",
+                },
+            }],
+        })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Static Site Example
 
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_digitalocean as digitalocean
 
-        static_site_example = digitalocean.App("static-site-example", spec=digitalocean.AppSpecArgs(
-            name="static-site-example",
-            region="ams",
-            static_sites=[digitalocean.AppSpecStaticSiteArgs(
-                build_command="bundle exec jekyll build -d ./public",
-                git=digitalocean.AppSpecStaticSiteGitArgs(
-                    branch="main",
-                    repo_clone_url="https://github.com/digitalocean/sample-jekyll.git",
-                ),
-                name="sample-jekyll",
-                output_dir="/public",
-            )],
-        ))
+        static_site_example = digitalocean.App("static-site-example", spec={
+            "name": "static-site-example",
+            "region": "ams",
+            "static_sites": [{
+                "name": "sample-jekyll",
+                "build_command": "bundle exec jekyll build -d ./public",
+                "output_dir": "/public",
+                "git": {
+                    "repo_clone_url": "https://github.com/digitalocean/sample-jekyll.git",
+                    "branch": "main",
+                },
+            }],
+        })
+        ```
+
+        ### Log Destination Example with Opensearch
+
+        ```python
+        import pulumi
+        import pulumi_digitalocean as digitalocean
+
+        golang_sample = digitalocean.App("golang-sample", spec={
+            "name": "golang-sample",
+            "region": "ams",
+            "services": [{
+                "name": "go-service",
+                "instance_count": 1,
+                "instance_size_slug": "apps-s-1vcpu-1gb",
+                "git": {
+                    "repo_clone_url": "https://github.com/digitalocean/sample-golang.git",
+                    "branch": "main",
+                },
+                "log_destinations": [{
+                    "name": "MyLogs",
+                    "open_search": {
+                        "endpoint": "https://something:1234",
+                        "basic_auth": {
+                            "user": "user",
+                            "password": "hi",
+                        },
+                    },
+                }],
+            }],
+        })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 
@@ -367,8 +474,9 @@ class App(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
+                 dedicated_ips: Optional[pulumi.Input[Sequence[pulumi.Input[Union['AppDedicatedIpArgs', 'AppDedicatedIpArgsDict']]]]] = None,
                  project_id: Optional[pulumi.Input[str]] = None,
-                 spec: Optional[pulumi.Input[pulumi.InputType['AppSpecArgs']]] = None,
+                 spec: Optional[pulumi.Input[Union['AppSpecArgs', 'AppSpecArgsDict']]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -378,12 +486,14 @@ class App(pulumi.CustomResource):
                 raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
             __props__ = AppArgs.__new__(AppArgs)
 
+            __props__.__dict__["dedicated_ips"] = dedicated_ips
             __props__.__dict__["project_id"] = project_id
             __props__.__dict__["spec"] = spec
             __props__.__dict__["active_deployment_id"] = None
             __props__.__dict__["app_urn"] = None
             __props__.__dict__["created_at"] = None
             __props__.__dict__["default_ingress"] = None
+            __props__.__dict__["live_domain"] = None
             __props__.__dict__["live_url"] = None
             __props__.__dict__["updated_at"] = None
         super(App, __self__).__init__(
@@ -399,10 +509,12 @@ class App(pulumi.CustomResource):
             active_deployment_id: Optional[pulumi.Input[str]] = None,
             app_urn: Optional[pulumi.Input[str]] = None,
             created_at: Optional[pulumi.Input[str]] = None,
+            dedicated_ips: Optional[pulumi.Input[Sequence[pulumi.Input[Union['AppDedicatedIpArgs', 'AppDedicatedIpArgsDict']]]]] = None,
             default_ingress: Optional[pulumi.Input[str]] = None,
+            live_domain: Optional[pulumi.Input[str]] = None,
             live_url: Optional[pulumi.Input[str]] = None,
             project_id: Optional[pulumi.Input[str]] = None,
-            spec: Optional[pulumi.Input[pulumi.InputType['AppSpecArgs']]] = None,
+            spec: Optional[pulumi.Input[Union['AppSpecArgs', 'AppSpecArgsDict']]] = None,
             updated_at: Optional[pulumi.Input[str]] = None) -> 'App':
         """
         Get an existing App resource's state with the given name, id, and optional extra
@@ -414,14 +526,16 @@ class App(pulumi.CustomResource):
         :param pulumi.Input[str] active_deployment_id: The ID the app's currently active deployment.
         :param pulumi.Input[str] app_urn: The uniform resource identifier for the app.
         :param pulumi.Input[str] created_at: The date and time of when the app was created.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['AppDedicatedIpArgs', 'AppDedicatedIpArgsDict']]]] dedicated_ips: The dedicated egress IP addresses associated with the app.
         :param pulumi.Input[str] default_ingress: The default URL to access the app.
+        :param pulumi.Input[str] live_domain: The live domain of the app.
         :param pulumi.Input[str] live_url: The live URL of the app.
         :param pulumi.Input[str] project_id: The ID of the project that the app is assigned to.
                
                A spec can contain multiple components.
                
                A `service` can contain:
-        :param pulumi.Input[pulumi.InputType['AppSpecArgs']] spec: A DigitalOcean App spec describing the app.
+        :param pulumi.Input[Union['AppSpecArgs', 'AppSpecArgsDict']] spec: A DigitalOcean App spec describing the app.
         :param pulumi.Input[str] updated_at: The date and time of when the app was last updated.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -431,7 +545,9 @@ class App(pulumi.CustomResource):
         __props__.__dict__["active_deployment_id"] = active_deployment_id
         __props__.__dict__["app_urn"] = app_urn
         __props__.__dict__["created_at"] = created_at
+        __props__.__dict__["dedicated_ips"] = dedicated_ips
         __props__.__dict__["default_ingress"] = default_ingress
+        __props__.__dict__["live_domain"] = live_domain
         __props__.__dict__["live_url"] = live_url
         __props__.__dict__["project_id"] = project_id
         __props__.__dict__["spec"] = spec
@@ -462,6 +578,14 @@ class App(pulumi.CustomResource):
         """
         return pulumi.get(self, "created_at")
 
+    @property
+    @pulumi.getter(name="dedicatedIps")
+    def dedicated_ips(self) -> pulumi.Output[Sequence['outputs.AppDedicatedIp']]:
+        """
+        The dedicated egress IP addresses associated with the app.
+        """
+        return pulumi.get(self, "dedicated_ips")
+
     @property
     @pulumi.getter(name="defaultIngress")
     def default_ingress(self) -> pulumi.Output[str]:
@@ -470,6 +594,14 @@ class App(pulumi.CustomResource):
         """
         return pulumi.get(self, "default_ingress")
 
+    @property
+    @pulumi.getter(name="liveDomain")
+    def live_domain(self) -> pulumi.Output[str]:
+        """
+        The live domain of the app.
+        """
+        return pulumi.get(self, "live_domain")
+
     @property
     @pulumi.getter(name="liveUrl")
     def live_url(self) -> pulumi.Output[str]: