Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/moimhossain/azure-communication-servicve-demo

Demo on email, chat etc. using ACS
https://github.com/moimhossain/azure-communication-servicve-demo

Last synced: about 9 hours ago
JSON representation

Demo on email, chat etc. using ACS

Awesome Lists containing this project

README

        

# Getting Started

### Reference Documentation
For further reference, please consider the following sections:

* [Official Apache Maven documentation](https://maven.apache.org/guides/index.html)
* [Spring Boot Maven Plugin Reference Guide](https://docs.spring.io/spring-boot/docs/3.1.1/maven-plugin/reference/html/)
* [Create an OCI image](https://docs.spring.io/spring-boot/docs/3.1.1/maven-plugin/reference/html/#build-image)
* [Spring Web](https://docs.spring.io/spring-boot/docs/3.1.1/reference/htmlsingle/#web)

### Guides
The following guides illustrate how to use some features concretely:

* [Building a RESTful Web Service](https://spring.io/guides/gs/rest-service/)
* [Serving Web Content with Spring MVC](https://spring.io/guides/gs/serving-web-content/)
* [Building REST services with Spring](https://spring.io/guides/tutorials/rest/)

### Environment variables

You would need some environment variables to make it work.

- ```ACS_SENDER_EMAIL```: The email address that will be used to send emails.
- ```ACS_ENDPOINT```: The endpoint of the Azure Communication Service.
- ```ACS_SMS_ENDPOINT```: The endpoint of the Azure Communication Service for SMS.
- ```AZ_UAMI_CLIENTID```: The client id of User Assigned Managed Identity.

You can set them in local mahcine like below

```
export ACS_SENDER_EMAIL="[email protected]"
export ACS_ENDPOINT="XXX"
export ACS_SMS_ENDPOINT="XXX"
```

> When running locally, you need to change the supply the following, and remove the ```AZ_UAMI_CLIENTID``` environment variable.

```
export AZURE_CLIENT_ID=""
export AZURE_CLIENT_SECRET=""
export AZURE_TENANT_ID=""
```

#### Compile/Recompile the package

> Sometimes ```./mvnw``` gives a bad interpreter for unix/dos incompatible line endings, in that case use ```mv.sh```

```
./mvnw clean package
```

#### Running locally
```
./mvnw spring-boot:run
```

With Docker,
```
docker run --rm -e AZ_COMMUNICATION_SERVICE_CONN_STRING="XXX" -e AZ_COMM_SMS_CONN_STR="XXX" -p 8081:8080 moimhossain/acsemailservice:beta1
```