Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions Configuration/src/ConfigurationProviders/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,13 +35,23 @@ This sample expects the config server to be backed by the `spring-cloud-samples`
```shell
cf target -o your-org -s your-space
```
1. Run the `cf push` command to deploy from source
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the app

- **From Source:**

```shell
cf push
```

- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs configuration-providers-sample`.

## Running on Tanzu Platform for Kubernetes

### Config Server deployment
Expand Down
14 changes: 12 additions & 2 deletions Connectors/src/MongoDb/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,22 @@ Upon startup, the app inserts a couple of objects into the bound MongoDB databas
cf marketplace -e your-offering
cf create-service csb-azure-mongodb your-plan sampleMongoDbService --wait
```
1. Run the `cf push` command to deploy from source (you can monitor logs with `cf logs mongodb-connector-sample`)
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the app

- **From Source:**

```shell
cf push
```

- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs mongodb-connector-sample`.
Comment thread
bart-vmware marked this conversation as resolved.
1. Copy the value of `routes` in the output and open in your browser

## Running on Tanzu Platform for Kubernetes
Expand Down
14 changes: 12 additions & 2 deletions Connectors/src/MySql/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,12 +50,22 @@ Upon startup, the app inserts a couple of rows into the bound MySQL database. Th
```shell
cf create-service csb-aws-mysql your-plan sampleMySqlService --wait
```
1. Run the `cf push` command to deploy from source (you can monitor logs with `cf logs mysql-connector-sample`)
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the app

- **From Source:**

```shell
cf push
```

- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs mysql-connector-sample`.
1. Copy the value of `routes` in the output and open in your browser

## Running on Tanzu Platform for Kubernetes
Expand Down
14 changes: 12 additions & 2 deletions Connectors/src/MySqlEFCore/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,12 +49,22 @@ Upon startup, the app inserts a couple of rows into the bound MySQL database. Th
```shell
cf create-service csb-aws-mysql your-plan sampleMySqlEFCoreService --wait
```
1. Run the `cf push` command to deploy from source (you can monitor logs with `cf logs mysql-efcore-connector-sample`)
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the app

- **From Source:**

```shell
cf push
```

- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs mysql-efcore-connector-sample`.
1. Copy the value of `routes` in the output and open in your browser

## Running on Tanzu Platform for Kubernetes
Expand Down
14 changes: 12 additions & 2 deletions Connectors/src/PostgreSql/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,12 +50,22 @@ Upon startup, the app inserts a couple of rows into the bound PostgreSQL databas
```shell
cf create-service csb-aws-postgresql your-plan samplePostgreSqlService --wait
```
1. Run the `cf push` command to deploy from source (you can monitor logs with `cf logs postgresql-connector-sample`)
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the app

- **From Source:**

```shell
cf push
```

- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs postgresql-connector-sample`.
1. Copy the value of `routes` in the output and open in your browser

## Running on Tanzu Platform for Kubernetes
Expand Down
14 changes: 12 additions & 2 deletions Connectors/src/PostgreSqlEFCore/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,12 +49,22 @@ Upon startup, the app inserts a couple of rows into the bound PostgreSQL databas
```shell
cf create-service csb-aws-postgresql your-plan samplePostgreSqlEFCoreService --wait
```
1. Run the `cf push` command to deploy from source (you can monitor logs with `cf logs postgresql-efcore-connector-sample`)
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the app

- **From Source:**

```shell
cf push
```

- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs postgresql-efcore-connector-sample`.
1. Copy the value of `routes` in the output and open in your browser

## Running on Tanzu Platform for Kubernetes
Expand Down
14 changes: 12 additions & 2 deletions Connectors/src/RabbitMQ/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,12 +34,22 @@ To receive a RabbitMQ message that you have sent: click the Receive button. Mess
cf marketplace -e your-offering
cf create-service p.rabbitmq your-plan sampleRabbitMQService --wait
```
1. Run the `cf push` command to deploy from source (you can monitor logs with `cf logs rabbitmq-connector-sample`)
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the app

- **From Source:**

```shell
cf push
```

- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs rabbitmq-connector-sample`.
1. Copy the value of `routes` in the output and open in your browser

## Running on Tanzu Platform for Kubernetes
Expand Down
14 changes: 12 additions & 2 deletions Connectors/src/Redis/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,12 +54,22 @@ Upon startup, the app inserts a couple of key/value pairs into the bound Redis/V
```shell
cf create-service csb-aws-redis your-plan sampleRedisService --wait
```
1. Run the `cf push` command to deploy from source (you can monitor logs with `cf logs redis-connector-sample`)
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the app

- **From Source:**

```shell
cf push
```

- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs redis-connector-sample`.
1. Copy the value of `routes` in the output and open in your browser

## Running on Tanzu Platform for Kubernetes
Expand Down
14 changes: 12 additions & 2 deletions Connectors/src/SqlServerEFCore/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,12 +42,22 @@ Upon startup, the app inserts a couple of rows into the bound SQL Server databas
```shell
cf create-service csb-aws-mssql your-plan sampleSqlServerService --wait
```
1. Run the `cf push` command to deploy from source (you can monitor logs with `cf logs sqlserver-efcore-connector-sample`)
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the app

- **From Source:**

```shell
cf push
```

- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs sqlserver-efcore-connector-sample`.
1. Copy the value of `routes` in the output and open in your browser

---
Expand Down
14 changes: 12 additions & 2 deletions Discovery/src/FortuneTeller/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,13 +138,23 @@ This variant uses service instances that are registered in [Spring Cloud Eureka]
cf marketplace -e your-offering
cf create-service p.service-registry your-plan sampleDiscoveryService --wait
```
1. Run the `cf push` command from the FortuneTellerApi directory, wait until it has started, then run it from the FortuneTellerWeb directory
- When deploying to Windows, binaries must be built locally before push. Use the following commands instead:
1. Deploy the apps. Follow these steps from the FortuneTellerApi directory first. Once that app has started, repeat these steps from the FortuneTellerWeb directory

* **From Source:**

```shell
cf push
```

* **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs [app-name]` (where "[app-name]" is either `fortune-service-sample` or `fortune-web-sample`).

### Running on Tanzu Platform for Cloud Foundry (Container-to-Container)

Same steps as above, but uncomment the related line in `manifest.yaml` before push. Additionally:
Expand Down
58 changes: 41 additions & 17 deletions Management/src/ActuatorApi/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ In order to demonstrate [Steeltoe Management Tasks](https://docs.steeltoe.io/api
dotnet run --runtask=ForecastWeather --fromDate=10/18/2024 --days=30
```

> [!NOTE]
> [!NOTE]
> For the `fromDate` parameter, use values formatted as `yyyy-dd-MM` or `MM/dd/yyyy`.

> [!TIP]
Expand Down Expand Up @@ -86,49 +86,73 @@ In order to demonstrate [Steeltoe Management Tasks](https://docs.steeltoe.io/api

1. Deploy the app

You can monitor logs with: `cf logs actuator-api-management-sample`.

- To deploy local sources, run the following commands:
- **From Source:**

```shell
dotnet build -t:WriteGitPropertiesFallbackFile
cf push
```

- To deploy locally-built binaries (required if deploying to Windows), run the following commands:
- **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs actuator-api-management-sample`.

1. Copy the value of `routes` in the output and open in your browser. The app should start and respond to requests, but the database still needs to be configured with the tasks listed in the next section.

> [!NOTE]
> [!NOTE]
> The provided manifest will create an app named `actuator-api-management-sample` and attempt to bind it to the MySql service `sampleActuatorMySqlService`.

### Running Tasks

Depending on the steps taken to push the application to Cloud Foundry, the commands below may require customization (for example, if the application was not published before pushing to a Linux cell, the path for the command might be `./bin/Debug/net10.0/linux-x64/Steeltoe.Samples.ActuatorApi`)
The commands listed below each include variations that align with the methods available for pushing the application to Cloud Foundry (source code or binaries). **Be sure to use the same option that was selected when the application was pushed or the command will fail.**

1. Apply Entity Framework Core database migration scripts:

```shell
cf run-task actuator-api-management-sample --command "./Steeltoe.Samples.ActuatorApi runtask=MigrateDatabase"
```
- Deployed Source:

```shell
cf run-task actuator-api-management-sample --command 'cd ../deps/0/dotnet_publish && ./Steeltoe.Samples.ActuatorApi runtask=MigrateDatabase'
```

- Deployed Binaries:

```shell
cf run-task actuator-api-management-sample --command "./Steeltoe.Samples.ActuatorApi runtask=MigrateDatabase"
```

1. Run [`ForecastTask`](./AdminTasks/ForecastTask.cs) to predict weather for the next 7 days:

```shell
cf run-task actuator-api-management-sample --command "./Steeltoe.Samples.ActuatorApi runtask=ForecastWeather"
```
- Deployed Source:

```shell
cf run-task actuator-api-management-sample --command 'cd ../deps/0/dotnet_publish && ./Steeltoe.Samples.ActuatorApi runtask=ForecastWeather'
```

- Deployed Binaries:

```shell
cf run-task actuator-api-management-sample --command "./Steeltoe.Samples.ActuatorApi runtask=ForecastWeather"
```

> [!TIP]
> [!TIP]
> To remove all forecast data, run [`ResetTask`](./AdminTasks/ResetTask.cs):
>
> ```shell
> cf run-task actuator-api-management-sample --command "./Steeltoe.Samples.ActuatorApi runtask=ResetWeather"
> ```
> - Deployed Source:
>
> ```shell
> cf run-task actuator-api-management-sample --command 'cd ../deps/0/dotnet_publish && ./Steeltoe.Samples.ActuatorApi runtask=ResetWeather'
> ```
>
> - Deployed Binaries:
>
> ```shell
> cf run-task actuator-api-management-sample --command "./Steeltoe.Samples.ActuatorApi runtask=ResetWeather"
> ```

---

Expand Down
4 changes: 2 additions & 2 deletions Management/src/ActuatorApi/testing/linux.feature
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,9 @@ Feature: Management
And you push: manifest.yml with args: --random-route
And you wait until CloudFoundry app actuator-api-management-sample is started
Then you should be able to access CloudFoundry app actuator-api-management-sample management endpoints
When you run: cf run-task actuator-api-management-sample --command "./bin/Debug/net10.0/linux-x64/Steeltoe.Samples.ActuatorApi runtask=MigrateDatabase --name MigrateDatabase"
When you run: cf run-task actuator-api-management-sample --command "cd ../deps/0/dotnet_publish && ./Steeltoe.Samples.ActuatorApi runtask=MigrateDatabase --name MigrateDatabase"
Comment thread
bart-vmware marked this conversation as resolved.
And you wait until CloudFoundry task MigrateDatabase for actuator-api-management-sample is successful
When you run: cf run-task actuator-api-management-sample --command "./bin/Debug/net10.0/linux-x64/Steeltoe.Samples.ActuatorApi runtask=ForecastWeather --name ForecastWeather"
When you run: cf run-task actuator-api-management-sample --command "cd ../deps/0/dotnet_publish && ./Steeltoe.Samples.ActuatorApi runtask=ForecastWeather --name ForecastWeather"
And you wait until CloudFoundry task ForecastWeather for actuator-api-management-sample is successful
When you get https://actuator-api-management-sample/weatherforecast
Then the response should contain "temperatureF"
Expand Down
8 changes: 3 additions & 5 deletions Management/src/ActuatorWeb/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -155,22 +155,20 @@ When running with Podman, update these files to use `host.containers.internal`:

1. Deploy the app

You can monitor logs with: `cf logs actuator-web-management-sample`.

- To deploy local sources, run the following commands:
* **From Source:**

```shell
dotnet build -t:WriteGitPropertiesFallbackFile
cf push
```

- To deploy locally-built binaries (required if deploying to Windows), run the following commands:
* **From Binaries** (required if deploying to Windows):

```shell
dotnet publish -r win-x64 --self-contained
cf push -f manifest-windows.yml -p bin/Release/net10.0/win-x64/publish
```

For either deployment option, monitor startup logs with: `cf logs actuator-web-management-sample`.
1. Copy the value of `routes` in the output and open in your browser
1. Refer to [ActuatorApi README](../ActuatorApi/README.md#running-on-tanzu-platform-for-cloud-foundry) for additional instructions.

Expand Down
Loading