{"id":18336014,"url":"https://github.com/auritylab/spring-gcp-tasks","last_synced_at":"2026-04-29T15:01:43.905Z","repository":{"id":48499011,"uuid":"192793054","full_name":"AurityLab/spring-gcp-tasks","owner":"AurityLab","description":"GCP Cloud Tasks in Spring","archived":false,"fork":false,"pushed_at":"2021-07-22T17:31:45.000Z","size":767,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-17T22:07:08.461Z","etag":null,"topics":["cloud-tasks","experimental","kotlin","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AurityLab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-19T19:33:58.000Z","updated_at":"2025-02-18T14:58:39.000Z","dependencies_parsed_at":"2022-08-26T03:24:53.590Z","dependency_job_id":null,"html_url":"https://github.com/AurityLab/spring-gcp-tasks","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/AurityLab/spring-gcp-tasks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AurityLab%2Fspring-gcp-tasks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AurityLab%2Fspring-gcp-tasks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AurityLab%2Fspring-gcp-tasks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AurityLab%2Fspring-gcp-tasks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AurityLab","download_url":"https://codeload.github.com/AurityLab/spring-gcp-tasks/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AurityLab%2Fspring-gcp-tasks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32430803,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T13:34:34.882Z","status":"ssl_error","status_checked_at":"2026-04-29T13:34:29.830Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud-tasks","experimental","kotlin","spring-boot"],"created_at":"2024-11-05T20:05:33.236Z","updated_at":"2026-04-29T15:01:43.880Z","avatar_url":"https://github.com/AurityLab.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spring GCP Cloud Tasks library\n\nSpring-gcp-tasks is a small **experimental** library to integrate GCP Cloud Tasks into Spring projects.\n\nNote: *This isn't production tested, but the library is in a finished state.*\n\n---\n\n* [Installation](https://github.com/AurityLab/spring-gcp-tasks#installation)\n* [Compatibility](https://github.com/AurityLab/spring-gcp-tasks#compatibility)\n* [Properties](https://github.com/AurityLab/spring-gcp-tasks#properties)\n* [Usage](https://github.com/AurityLab/spring-gcp-tasks#usage)\n* [Example](https://github.com/AurityLab/spring-gcp-tasks#example)\n\n---\n\n### Installation\n\nRepository: `https://maven.pkg.github.com/AurityLab/spring-gcp-tasks`\n\nGradle:\n```groovy\ndependencies {\n    implementation \"com.auritylab:spring-gcp-tasks:0.1.19\"\n}\n```\n\nMaven:\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.auritylab\u003c/groupId\u003e\n  \u003cartifactId\u003espring-gcp-tasks\u003c/artifactId\u003e\n  \u003cversion\u003e0.1.19\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Compatibility\n\nThis library is compatible with spring cloud `Hoxton` or higher (at least `Hoxton.M2`).\n\nFor everything below `Hoxton.M2` (`Greenwich` etc.) you **have** to use google-cloud-bom version `0.99.0-alpha` or higher:\n\nGradle:\n```groovy\ndependencyManagement {\n    imports {\n        mavenBom(\"org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}\") {\n            bomProperty \"google-cloud-bom.version\", \"0.99.0-alpha\"\n        }\n    }\n}\n```\n\nMaven:\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.google.cloud\u003c/groupId\u003e\n    \u003cartifactId\u003egoogle-cloud-bom\u003c/artifactId\u003e\n    \u003cversion\u003e0.99.0-alpha\u003c/version\u003e\n    \u003ctype\u003epom\u003c/type\u003e\n    \u003cscope\u003eimport\u003c/scope\u003e\n\u003c/dependency\u003e\n\n\u003cdependencyManagement\u003e\n    \u003cdependencies\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003eorg.springframework.cloud\u003c/groupId\u003e\n            \u003cartifactId\u003espring-cloud-dependencies\u003c/artifactId\u003e\n            \u003cversion\u003e${spring-cloud.version}\u003c/version\u003e\n            \u003ctype\u003epom\u003c/type\u003e\n            \u003cscope\u003eimport\u003c/scope\u003e\n        \u003c/dependency\u003e\n    \u003c/dependencies\u003e\n\u003c/dependencyManagement\u003e\n```\n\nReplace `${springCloudVersion}` with your version (e.g. `Greenwich.SR2`).\n\n### Properties\n\nPrefix for all properties: `com.auritylab.spring.gcp.tasks`\n\nProperty | Default | Required | Type | Description\n------------ | ------------- | ------------- | ------------- | -------------\n`signature-secret` | **nothing** | **yes** | `String` | Used for signing tasks before submitting to Cloud Tasks.\n`default-project-id` | `null` | **no** | `String?` | Used when nothing specified in `@CloudTask` annotation.\n`default-location-id` | `null` | **no** | `String?` | Used when nothing specified in `@CloudTask` annotation.\n`default-queue-id` | `null` | **no** | `String?` | Used when nothing specified in `@CloudTask` annotation.\n`default-worker-endpoint` | `null` | **no** | `String?` | Used when nothing specified in `@CloudTask` annotation.\n`default-worker-endpoint-route` | `\"/taskhandler\"` | **default** | `String` | Used when nothing specified in `@CloudTask` annotation.\n`default-worker-route` | `\"\"` | **default** | `String` | Used when nothing specified in `@CloudTask` annotation.\n`skip-cloud-tasks` | `false` | **default** | `Boolean` | Task submissions will be sent to the task's worker endpoint directly skipping Cloud Tasks.\n`skip-task-endpoint` | `false` | **default** | `Boolean` | Task will be executed directly without networking (task's execute method blocks until task finished).\n`queue-id-global-prefix` | `\"\"` | **default** | `String` | Prefix used for all queue ids. Useful for testing or staging.\n\nNote on types:\u003cbr\u003e`String` -\u003e non-nullable\u003cbr\u003e`String?` -\u003e nullable\n\nAlso note that `default-worker-endpoint-route` and `default-worker-route` are two different properties.\nThe former is used for the actual route to send the task to (in combination with `default-worker-endpoint`).\nThe latter is a *virtual* route to map the task to the right worker.\n\n### Usage\n\nThere are two annotations for auto configuration:\u003cbr\u003e\n`@EnableCloudTasks` and `@EnableCloudTasksWithEndpoint`\n\nThe former enables spring-gcp-tasks functionality, but disables the worker endpoint.\n\nThe latter also enables the worker endpoint via a rest controller mapped to the route specified\nin `com.auritylab.spring.gcp.tasks.default-worker-endpoint-route`. A configured web server is needed for this.\n\n```kotlin\n@SpringBootApplication\n// or @EnableCloudTasks to disable worker endpoint\n@EnableCloudTasksWithEndpoint\nclass Application\n\nfun main(args: Array\u003cString\u003e) {\n    runApplication\u003cApplication\u003e(*args)\n}\n```\n\n### Example\n\nWriting a task worker:\n\n```kotlin\n@CloudTask(route = \"/notification\")\nclass NotificationWorker : TaskWorker\u003cNotificationWorker.Payload\u003e(Payload::class) {\n    override fun run(payload: Payload, id: UUID) {\n        println(\"New notification task: $payload\")\n    }\n\n    data class Payload(val str: String)\n}\n```\n\nExecuting a task with worker above:\n\n```kotlin\nclass NotificationTest(\n    private val notificationWorker: NotificationWorker\n) {\n    fun execute() {\n        notificationWorker.execute(\n            NotificationWorker.Payload(\"test\")\n        )\n    }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fauritylab%2Fspring-gcp-tasks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fauritylab%2Fspring-gcp-tasks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fauritylab%2Fspring-gcp-tasks/lists"}