Cloud Runtimes Specification for the JVM

<project>
    ...
    <dependencies>
        ...
        <!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
        <dependency>
            <groupId>group.rxcloud</groupId>
            <artifactId>cloud-runtimes-api</artifactId>
            <version>1.0.1.RELEASE</version>
        </dependency>
        ...
    </dependencies>
    ...
</project>

For a Gradle project, add the following to your build.gradle file:

dependencies {
...
   // https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api
   implementation group: 'group.rxcloud', name: 'cloud-runtimes-api', version: '1.0.1.RELEASE'
}

Comments

feat: add saas alpha api
saas cryption api

saas email api

saas im api

saas ivr api

saas proxy api

saas sms api

Description

Please explain the changes you've made

Issue reference

We strive to have all PR being opened based on an issue, where the problem or feature have been discussed prior to implementation.

Please reference the issue this PR will close: #[issue number]

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

[ ] Code compiles correctly

[ ] Created/updated tests

[ ] Extended the documentation
opened by kevinten10 1
feat: add s3 api.
Description

add s3 api.

Issue reference

#48

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

[x] Code compiles correctly

[x] Created/updated tests

[x] Extended the documentation
opened by ZakiFan 1
feat: add s3 api.
Description

add s3 api.

Issue reference

#48

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

[x] Code compiles correctly

[x] Created/updated tests

[x] Extended the documentation
opened by ZakiFan 1
feature: add `toString` to all java entity.
Description

optimize: add toString to all java entity.

Issue reference

https://github.com/reactivegroup/capa/issues/63

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

[x] Code compiles correctly

[x] Created/updated tests

[x] Extended the documentation
opened by kevinten10 1
feat: add multi component client supported
Description

feat: add multi component client supported

fix: fix https://github.com/reactivegroup/cloud-runtimes-jvm/issues/24

Issue reference

https://github.com/reactivegroup/cloud-runtimes-jvm/issues/41

https://github.com/reactivegroup/cloud-runtimes-jvm/issues/24

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

[x] Code compiles correctly

[x] Created/updated tests

[x] Extended the documentation
opened by kevinten10 1
Add telemetry traces and metrics interfaces.
Description

Add telemetry traces and metrics interfaces, which were designed based on open-telemetry api 1.9.0/1.9.0-alpha.

Please explain the changes you've made

Issue reference

#5 #25

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

[x] Code compiles correctly

[ ] Created/updated tests

[x] Extended the documentation
opened by JasmineJ1230 1
feat: add schedule module extended api
Description

add schedule module extended api

Issue reference

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

[x] Code compiles correctly

[x] Created/updated tests

[x] Extended the documentation
opened by kevinten10 1
Add telemetry-trace interfaces, which were designed based on open-tel…
Add telemetry-trace interfaces, which were designed based on open-telemetry api 1.7.0.

Update the version to 1.0.7.RELEASE.

Description

Add the very first version of telemetry api, which only includes traces. According to recent research about metrics utils, the API depends on the open-telemetry api (version 1.7.0).

Issue reference

#5 #25

Checklist

[x] Code compiles correctly

[x] Created/updated tests

[x] Extended the documentation
opened by JasmineJ1230 1
feat: add config module extended api, and then release
Description

feat: add config module extended api

chore: add more developer info

Issue reference

https://github.com/reactivegroup/cloud-runtimes-jvm/issues/23

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

[ ] Code compiles correctly

[ ] Created/updated tests

[ ] Extended the documentation
opened by kevinten10 1
[Test]
Description

test

Issue reference

We strive to have all PR being opened based on an issue, where the problem or feature have been discussed prior to implementation.

Please reference the issue this PR will close: #[issue number]

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

[ ] Code compiles correctly

[ ] Created/updated tests

[ ] Extended the documentation
opened by pinxiong 1
[Bug] The naming of parameters is not uniform in InvocationRuntimes
[x] I have searched the issues of this repository and believe that this is not a duplicate.

Environment

cloud-runtimes-jvm version: 1.0.2-SNAPSHOT

branch: master

Expected Behavior

The naming of parameters is uniform

Actual Behavior
opened by Huijing-Xu 1
[Feature] Add s3 api.

Describe the feature

We defined the s3 api in NativeAwsS3Runtimes, including the apis to file upload or file download.

Release Note

RELEASE NOTE: ADD Defined s3 apis.

opened by ZakiFan 0
[Feature] Add telemetry apis about traces.

Describe the feature

We defined the api about traces in TelemetryRuntimes, including the apis to build a named tracer, and to get the context propagators which was initialize when the client was built.

Release Note

RELEASE NOTE: ADD Defined telemetry apis about traces.

opened by JasmineJ1230 1
[Discussion] Metric Api Design with Open Telemetry
一、设计目标

监控相关日志类型主要有 Trace、Metrics、Logs 三种，即调用链追踪、数据指标、文本日志。具体说明可参考 OpenTelemetry - Data sources。

结合Capa整体的设计目标，我们需要为以上三种类型日志的提供通用API和SDK。下层实现根据环境不同自动切换，将日志数据发往不同的监控服务。

二、API方案调研

监控方面，业界普遍认可的方案是 Open Telemetry 的设计。Open Telemetry为以上三种日志类型提供统一的API，以及多语言的SDK实现。可通过 直接发送 / side car 的方式发送采集的日志数据。可利用其SDK自身提供的导出逻辑实现，也可自定义开发导出逻辑，将数据发送到需要的监控服务。

前期调研的基本情况可见 Open Telemetry调研。使用效果见 Demo 演示。

Capa的设计目标与Open Telemetry是契合的。考虑到工作量和日后在各个平台上的兼容性，我们可以尽可能复用其API和SDK，在需要的地方做一些封装和扩展。

Trace 和 Metrics 的API，Open Telemetry已有稳定版本，考虑到未来发展和兼容性，建议在API层尽量少做修改，使用其已有规范进行开发。

Logs API仍在设计中。而目前在实际开发中，最常使用的Log4j2。建议Java可先基于Log4j2按需开发自定义Appenders，满足当前的日志记录需求。

三、基于现实上云需求的调研和开发工作评估

Capa目前仅集中在应用层面的日志数据采集，即开发者的业务逻辑埋点 和其他中间件内部埋点。为满足上云需求，对于以上三种日志类型，初期我们计划使用的监控服务以及需要的coding工作如下：

| 日志类型 | AWS监控服务 | 开发工作 | Ctrip监控服务 | 开发工作 | | ------------- | ----- | ---- | ---- | ---- | | Trace & Metrics | / | Data Collector模式 - 配置 / SDK 模式 - Pipeline构建 | / | SDK 模式 - Pipeline构建 | | Trace | X-Ray | Data Collector模式 - 额外部署 / SDK 模式 - Exporter | Cat Transaction | SDK 模式 - Exporter | | Metrics | Cloud Watch | Data Collector模式 - 额外部署 / SDK 模式 - Exporter | Hickwall | SDK 模式 - Exporter | | Logs | Cloud Watch Logs（暂定） | log4j2 自定义Appender | Clog | log4j2 自定义Appender |

对于在Ctrip的监控，我们需要关注的埋点内容主要是业务逻辑埋点。可以采用SDK直接导出的方式，我们需要自己实现 所有的数据导出逻辑（Exporter）。

对于在AWS的监控，数据采集方面，AWS基于Open Telemetry提供了一些扩展功能，可采用手动埋点或者agent自动埋点（字节码注入）的方式，对AWS的SDK自动埋点。操作方式

数据导出方面，开发量取决于我们选择的方案。 | 部署方式 | 优点 | 缺点 | | ------------- | ------------- | ------------- | | SDK直接导出 | 逻辑透明，且资源消耗相对小 | 需要开发所有的数据导出逻辑 | | Data Collector | 无额外开发量 | 需要以Sidecar或独立服务的方式另外部署，与Capa最初的设计目标不完全相符，且逻辑相对黑盒 |

基于使用的灵活性，建议采用SDK的方式开发。

四、相关文档

Open Telemetry官方文档：https://opentelemetry.io/docs/concepts

Open Telemetry项目地址：https://github.com/open-telemetry

java应用自动监控功能文档：https://github.com/open-telemetry/opentelemetry-java-instrumentation#getting-started

Open Telemetry milestone（未发布功能的上线时间计划）：https://github.com/open-telemetry/opentelemetry-specification/milestones

支持组件查询：https://opentelemetry.io/registry

AWS Distro for OpenTelemetry文档：https://aws-otel.github.io/docs/introduction
opened by JasmineJ1230 0
[Disccusion] Database(SQL) API design.
Goal

Design Database(SQL) API, like DB Mesh.

The current state API is essentially a key/value model API and does not support SQL query.

But:

The database is so populor that almost every application is using it, we want to make the development as simple as we can.

If we use state api or binding api, the database semantics are not very clear. There are some operation in dababase, but the operation can't be expressed clearly in state and binding api.

In some database implements, such as PreparedStatement, we use it to void the Security Problem(SQL Injection).

Progress

We can first refer to some information and define a first version of the API.

Reference

https://github.com/mosn/layotto/issues/101 https://github.com/dapr/dapr/issues/3339 https://github.com/dapr/dapr/issues/1339 https://github.com/dapr/dapr/issues/3354
opened by kevinten10 3

Releases(1.19.RELEASE)

1.19.RELEASE(Nov 20, 2022)
Cloud Runtimes Specification for the JVM.

Release 1.19.RELEASE version to maven.

Features

refactor: refactor sequencer id type from int to long

release: release 1.19.RELEASE version

Get started

 <dependency> <groupId>group.rxcloud</groupId> <artifactId>cloud-runtimes-api</artifactId> <version>1.19.RELEASE</version> </dependency>
Source code(tar.gz)
Source code(zip)

1.18.REALEASE(Oct 19, 2022)

Cloud Runtimes Specification for the JVM.

Release 1.18.RELEASE version to maven.

Features

feat: add more native.s3 api
release: release 1.18.RELEASE version

Get started

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.18.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.17.RELEASE(Sep 9, 2022)

Cloud Runtimes Specification for the JVM.

Release 1.17.RELEASE version to maven.

Features

feat: add saas api
release: release 1.17.RELEASE version

Get started

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.17.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.15.RELEASE(Jun 13, 2022)
Cloud Runtimes Specification for the JVM.

Release 1.15.RELEASE version to maven.

Features

feat: add sequencer api

feat: add environment api

feat: add ratelimit api

refactor: update file api return value

release: release 1.15.RELEASE version

Get started

 <dependency> <groupId>group.rxcloud</groupId> <artifactId>cloud-runtimes-api</artifactId> <version>1.15.RELEASE</version> </dependency>
Source code(tar.gz)
Source code(zip)
1.13.RELEASE(Jun 7, 2022)
Cloud Runtimes Specification for the JVM.

Release 1.13.RELEASE version to maven.

Features

feat: add native redis api

feat: add native sql api

feat: add pubsub delay message api

refactor: refactor default client

docs: add more comments

release: release 1.13.RELEASE version

Get started

 <dependency> <groupId>group.rxcloud</groupId> <artifactId>cloud-runtimes-api</artifactId> <version>1.13.RELEASE</version> </dependency>
Source code(tar.gz)
Source code(zip)
1.12.RELEASE(Apr 12, 2022)
Cloud Runtimes Specification for the JVM.

Release 1.12.RELEASE version to maven.

Features

feat: add rpc server api

feat: add pubsub subscriber api

feat: add adaptor to capa module

feat: add adaptor to dapr module

feat: add adaptor to layotto module

refactor: optimize optional dependency

release: release 1.12.RELEASE version

Get started

 <dependency> <groupId>group.rxcloud</groupId> <artifactId>cloud-runtimes-api</artifactId> <version>1.12.RELEASE</version> </dependency>
Source code(tar.gz)
Source code(zip)

1.11.RELEASE(Dec 29, 2021)

Cloud Runtimes Specification for the JVM.

Release 1.11.RELEASE version to maven.

Features

chore develop

Get started

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.11.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.0.10.RELEASE(Dec 2, 2021)

Cloud Runtimes Specification for the JVM.

Release 1.0.10.RELEASE version to maven.

Features

add tostring to all java entity
add file api
add lock api

Get started

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.0.10.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.0.9.RELEASE(Nov 30, 2021)

Cloud Runtimes Specification for the JVM.

Release 1.0.9.RELEASE version to maven.

Features

support client with multi-component
optimize code style

Get started

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.0.9.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.0.8.RELEASE(Nov 17, 2021)
Cloud Runtimes Specification for the JVM.

Release 1.0.8.RELEASE version to maven.

Features

Add the first version Telemetry API.

Add the first version Database(SQL) API.

Add the first version Schedule API.

Get started

 <dependency> <groupId>group.rxcloud</groupId> <artifactId>cloud-runtimes-api</artifactId> <version>1.0.8.RELEASE</version> </dependency>
Source code(tar.gz)
Source code(zip)

1.0.7.RELEASE(Nov 15, 2021)

Cloud Runtimes Specification for the JVM.

Release 1.0.7.RELEASE version to maven.

Features

Add the first version Telemetry API.

Get started

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.0.7.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.0.6.RELEASE(Nov 14, 2021)

Cloud Runtimes Specification for the JVM.

Release 1.0.6.RELEASE version to maven.

Features

Regarding the redesign of the pubsub API.

Get started

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.0.6.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.0.5.RELEASE(Nov 14, 2021)

Cloud Runtimes Specification for the JVM.

Release 1.0.5.RELEASE version to maven.

Features

First version Database(SQL) API.

Get started

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.0.5.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.0.4.RELEASE(Oct 28, 2021)

Cloud Runtimes Specification for the JVM.

Release 1.0.4.RELEASE version to maven.

You can used by:

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.0.4.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.0.2.RELEASE(Oct 25, 2021)

Cloud Runtimes Specification for the JVM.

Release 1.0.2.RELEASE version to maven.

You can used by:

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.0.2.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)

1.0.1.RELEASE(Sep 11, 2021)

Cloud Runtimes Specification for the JVM.

Release 1.0.1-RELEASE version to maven.

You can used by:

<!-- https://mvnrepository.com/artifact/group.rxcloud/cloud-runtimes-api -->
<dependency>
    <groupId>group.rxcloud</groupId>
    <artifactId>cloud-runtimes-api</artifactId>
    <version>1.0.1.RELEASE</version>
</dependency>

Source code(tar.gz)
Source code(zip)