Merge upstream/v1.16 into add-clickhouse-state-store-docs-v1.16

Author: middt

.github/workflows/website-root.yml

@@ -1,14 +1,14 @@
-name: Azure Static Web App v1.15
+name: Azure Static Web App v1.16
 
 on:
   workflow_dispatch:
   push:
     branches:
-      - v1.15
+      - v1.16
   pull_request:
     types: [opened, synchronize, reopened, closed]
     branches:
-      - v1.15
+      - v1.16
 
 jobs:
   build_and_deploy_job:
@@ -29,7 +29,7 @@ jobs:
           HUGO_ENV: production
           HUGO_VERSION: "0.100.2"
         with:
-          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_V1_15 }}
+          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_V1_16 }}
           repo_token: ${{ secrets.GITHUB_TOKEN }} # Used for Github integrations (i.e. PR comments)
           skip_deploy_on_missing_secrets: true
           action: "upload"
@@ -50,6 +50,6 @@ jobs:
         id: closepullrequest
         uses: Azure/static-web-apps-deploy@v1
         with:
-          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_V1_15 }}
+          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_V1_16 }}
           skip_deploy_on_missing_secrets: true
           action: "close"

.github/workflows/website-v1-15.yml renamed to .github/workflows/website-v1-16.yml

@@ -1,5 +1,5 @@
 # Site Configuration
-baseURL = "https://docs.dapr.io"
+baseURL = "https://v1-16.docs.dapr.io"
 title = "Dapr Docs"
 theme = "docsy"
 disableFastRender = true
@@ -200,20 +200,20 @@ offlineSearch = false
 github_repo = "https://github.com/dapr/docs"
 github_project_repo = "https://github.com/dapr/dapr"
 github_subdir = "daprdocs"
-github_branch = "v1.15"
+github_branch = "v1.16"
 
 # Versioning
-version_menu = "v1.15 (latest)"
-version = "v1.15"
+version_menu = "v1.16 (preview)"
+version = "v1.16"
 archived_version = false
 url_latest_version = "https://docs.dapr.io"
 
 [[params.versions]]
   version = "v1.16 (preview)"
-  url = "https://v1-16.docs.dapr.io"
+  url = "#"
 [[params.versions]]
   version = "v1.15 (latest)"
-  url = "#"
+  url = "https://docs.dapr.io"
 [[params.versions]]
   version = "v1.14"
   url = "https://v1-14.docs.dapr.io"
@@ -281,4 +281,4 @@ no = '<b>Sorry to hear that.</b> Please <a href="https://github.com/dapr/docs/is
 	name = "Zoom"
 	url = "https://aka.ms/dapr-community-call"
 	icon = "fas fa-video"
-  desc = "Meetings happen here!"
+  desc = "Meetings happen here!"

daprdocs/config.toml

@@ -59,7 +59,7 @@ Want to put the Dapr conversation API to the test? Walk through the following qu
 
 | Quickstart/tutorial | Description |
 | ------------------- | ----------- |
-| [Conversation quickstart]({{< ref conversation-quickstart.md >}}) | Learn how to  interact with Large Language Models (LLMs) using the conversation API. |
+| [Conversation quickstart]({{< ref conversation-quickstart.md >}}) | Learn how to interact with Large Language Models (LLMs) using the conversation API. |
 
 ### Start using the conversation API directly in your app
 

daprdocs/content/en/developing-applications/building-blocks/conversation/conversation-overview.md

@@ -19,8 +19,7 @@ All jobs are registered with a case-sensitive job name. These names are intended
 interfacing with the Dapr runtime. The name is used as an identifier when creating and modifying the job as well as 
 to indicate which job a triggered invocation is associated with.
 
-Only one job can be associated with a name at any given time. Any attempt to create a new job using the same name
-as an existing job will result in an overwrite of this existing job.
+Only one job can be associated with a name at any given time. By default, any attempt to create a new job using the same name as an existing job results in an error. However, if the `overwrite` flag is set to `true`, the new job overwrites the existing job with the same name. 
 
 ## Scheduling Jobs
 A job can be scheduled using any of the following mechanisms:
@@ -115,6 +114,7 @@ POST request to the endpoint `/job/<job-name>`. The body includes the following
 or the not-before time from which the schedule should take effect
 - `Ttl`: An optional value indicating when the job should expire
 - `Payload`: A collection of bytes containing data originally stored when the job was scheduled
+- `Overwrite`: A flag to allow the requested job to overwrite an existing job with the same name, if it already exists.
 
 The `DueTime` and `Ttl` fields will reflect an RC3339 timestamp value reflective of the time zone provided when the job was
 originally scheduled. If no time zone was provided, these values indicate the time zone used by the server running

daprdocs/content/en/developing-applications/building-blocks/jobs/jobs-features-concepts.md

@@ -53,11 +53,11 @@ Dapr's jobs API ensures the tasks represented in these scenarios are performed c
 
 ## Features
 
-The jobs API provides several features to make it easy for you to schedule jobs.
+The main functionality of the Jobs API allows you to create, retrieve, and delete scheduled jobs. By default, when you create a job with a name that already exists, the operation fails unless you explicitly set the `overwrite` flag to `true`. This ensures that existing jobs are not accidentally modified or overwritten.
 
 ### Schedule jobs across multiple replicas
 
-When you create a job, it replaces any existing job with the same name. This means that every time a job is created, it resets the count and only keeps 1 record in the embedded etcd for that job. Therefore, you don't need to worry about multiple jobs being created and firing off — only the most recent job is recorded and executed, even if all your apps schedule the same job on startup. 
+When you create a job, it does not replace an existing job with the same name, unless you explicitly set the `overwrite` flag. This means that every time a job is created, it resets the count and only keeps 1 record in the embedded etcd for that job. Therefore, you don't need to worry about multiple jobs being created and firing off — only the most recent job is recorded and executed, even if all your apps schedule the same job on startup. 
 
 The Scheduler service enables the scheduling of jobs to scale across multiple replicas, while guaranteeing that a job is only triggered by 1 Scheduler service instance. 
 

daprdocs/content/en/developing-applications/building-blocks/jobs/jobs-overview.md

@@ -37,6 +37,7 @@ Parameter | Description
 `dueTime` | An optional time at which the job should be active, or the "one shot" time, if other scheduling type fields are not provided. Accepts a "point in time" string in the format of RFC3339, Go duration string (calculated from creation time), or non-repeating ISO8601.
 `repeats` | An optional number of times in which the job should be triggered. If not set, the job runs indefinitely or until expiration.
 `ttl` | An optional time to live or expiration of the job. Accepts a "point in time" string in the format of RFC3339, Go duration string (calculated from job creation time), or non-repeating ISO8601.
+`overwrite` | A boolean value to specify if the job can overwrite an existing one with the same name. Default value is `false`
 
 #### schedule
 `schedule` accepts both systemd timer-style cron expressions, as well as human readable '@' prefixed period strings, as defined below.

daprdocs/content/en/reference/api/jobs_api.md

@@ -41,6 +41,24 @@ The following metadata options are **required** to authenticate using a PostgreS
 |--------|:--------:|---------|---------|
 | `connectionString` | Y | The connection string for the PostgreSQL database. See the PostgreSQL [documentation on database connections](https://www.postgresql.org/docs/current/libpq-connect.html) for information on how to define a connection string. | `"host=localhost user=postgres password=example port=5432 connect_timeout=10 database=my_db"`
 
+#### Authenticate using individual connection parameters
+
+In addition to using a connection string, you can optionally specify individual connection parameters. These parameters are equivalent to the standard PostgreSQL connection parameters.
+
+| Field  | Required | Details | Example |
+|--------|:--------:|---------|---------|
+| `host` | Y | The host name or IP address of the PostgreSQL server | `"localhost"` |
+| `hostaddr` | N | The IP address of the PostgreSQL server (alternative to host) | `"127.0.0.1"` |
+| `port` | Y | The port number of the PostgreSQL server | `"5432"` |
+| `database` | Y | The name of the database to connect to | `"my_db"` |
+| `user` | Y | The PostgreSQL user to connect as | `"postgres"` |
+| `password` | Y | The password for the PostgreSQL user | `"example"` |
+| `sslRootCert` | N | Path to the SSL root certificate file | `"/path/to/ca.crt"` |
+
+{{% alert title="Note" color="primary" %}}
+When using individual connection parameters, these will override the ones present in the `connectionString`.
+{{% /alert %}}
+
 ### Authenticate using Microsoft Entra ID
 
 Authenticating with Microsoft Entra ID is supported with Azure Database for PostgreSQL. All authentication methods supported by Dapr can be used, including client credentials ("service principal") and Managed Identity.

daprdocs/content/en/reference/components-reference/supported-bindings/postgresql.md

@@ -27,6 +27,21 @@ spec:
     # Name of the table which holds configuration information
     - name: table
       value: "[your_configuration_table_name]" 
+    # Individual connection parameters - can be used instead to override connectionString parameters
+    #- name: host
+    #  value: "localhost"
+    #- name: hostaddr
+    #  value: "127.0.0.1"
+    #- name: port
+    #  value: "5432"
+    #- name: database
+    #  value: "my_db"
+    #- name: user
+    #  value: "postgres"
+    #- name: password
+    #  value: "example"
+    #- name: sslRootCert
+    #  value: "/path/to/ca.crt"
     # Timeout for database operations, in seconds (optional)
     #- name: timeoutInSeconds
     #  value: 20
@@ -67,6 +82,24 @@ The following metadata options are **required** to authenticate using a PostgreS
 |--------|:--------:|---------|---------|
 | `connectionString` | Y | The connection string for the PostgreSQL database. See the PostgreSQL [documentation on database connections](https://www.postgresql.org/docs/current/libpq-connect.html) for information on how to define a connection string. | `"host=localhost user=postgres password=example port=5432 connect_timeout=10 database=my_db"`
 
+#### Authenticate using individual connection parameters
+
+In addition to using a connection string, you can optionally specify individual connection parameters. These parameters are equivalent to the standard PostgreSQL connection parameters.
+
+| Field  | Required | Details | Example |
+|--------|:--------:|---------|---------|
+| `host` | Y | The host name or IP address of the PostgreSQL server | `"localhost"` |
+| `hostaddr` | N | The IP address of the PostgreSQL server (alternative to host) | `"127.0.0.1"` |
+| `port` | Y | The port number of the PostgreSQL server | `"5432"` |
+| `database` | Y | The name of the database to connect to | `"my_db"` |
+| `user` | Y | The PostgreSQL user to connect as | `"postgres"` |
+| `password` | Y | The password for the PostgreSQL user | `"example"` |
+| `sslRootCert` | N | Path to the SSL root certificate file | `"/path/to/ca.crt"` |
+
+{{% alert title="Note" color="primary" %}}
+When using individual connection parameters, these will override the ones present in the `connectionString`.
+{{% /alert %}}
+
 ### Authenticate using Microsoft Entra ID
 
 Authenticating with Microsoft Entra ID is supported with Azure Database for PostgreSQL. All authentication methods supported by Dapr can be used, including client credentials ("service principal") and Managed Identity.

daprdocs/content/en/reference/components-reference/supported-configuration-stores/postgresql-configuration-store.md

@@ -0,0 +1,42 @@
+---
+type: docs
+title: "GoogleAI"
+linkTitle: "GoogleAI"
+description: Detailed information on the GoogleAI conversation component
+---
+
+## Component format
+
+A Dapr `conversation.yaml` component file has the following structure:
+
+```yaml
+apiVersion: dapr.io/v1alpha1
+kind: Component
+metadata:
+  name: googleai
+spec:
+  type: conversation.googleai
+  metadata:
+  - name: key
+    value: mykey
+  - name: model
+    value: gemini-1.5-flash
+  - name: cacheTTL
+    value: 10m
+```
+
+{{% alert title="Warning" color="warning" %}}
+The above example uses secrets as plain strings. It is recommended to use a secret store for the secrets, as described [here]({{< ref component-secrets.md >}}).
+{{% /alert %}}
+
+## Spec metadata fields
+
+| Field              | Required | Details | Example |
+|--------------------|:--------:|---------|---------|
+| `key`   | Y | API key for GoogleAI. | `mykey` |
+| `model` | N | The GoogleAI LLM to use. Defaults to `gemini-1.5-flash`.  | `gemini-2.0-flash` |
+| `cacheTTL` | N | A time-to-live value for a prompt cache to expire. Uses Golang duration format.  | `10m` |
+
+## Related links
+
+- [Conversation API overview]({{< ref conversation-overview.md >}})