pbm 1.0.0
See the version list below for details.
dotnet tool install --global pbm --version 1.0.0
dotnet new tool-manifest # if you are setting up this repo dotnet tool install --local pbm --version 1.0.0
#tool dotnet:?package=pbm&version=1.0.0
nuke :add-package pbm --version 1.0.0
CLI for managing Akka.NET applications and Akka.NET Clusters.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. |
.NET Core | netcoreapp2.1 is compatible. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 is compatible. |
This package has no dependencies.
Version | Downloads | Last updated |
---|---|---|
1.4.4 | 57 | 1/17/2025 |
1.4.3 | 24,458 | 6/17/2024 |
1.4.2 | 652 | 6/11/2024 |
1.4.1 | 13,444 | 3/18/2024 |
1.4.0 | 10,149 | 1/12/2024 |
1.3.3 | 544 | 1/10/2024 |
1.3.2 | 23,316 | 7/18/2023 |
1.3.1 | 8,713 | 5/4/2023 |
1.3.0 | 20,293 | 3/3/2023 |
1.3.0-beta1 | 267 | 3/1/2023 |
1.2.2 | 8,173 | 1/19/2023 |
1.2.1 | 4,036 | 12/19/2022 |
1.2.0 | 5,300 | 11/18/2022 |
1.1.4 | 167 | 7/17/2023 |
1.1.3 | 5,602 | 10/20/2022 |
1.1.2 | 4,018 | 9/28/2022 |
1.1.1 | 997 | 9/23/2022 |
1.1.0 | 17,070 | 6/9/2022 |
1.0.2 | 27,215 | 11/16/2021 |
1.0.1 | 13,624 | 8/3/2021 |
1.0.0 | 1,067 | 7/26/2021 |
0.8.5 | 10,130 | 5/3/2021 |
0.8.4 | 688 | 4/30/2021 |
0.8.3 | 7,663 | 3/18/2021 |
0.8.2 | 12,290 | 11/24/2020 |
0.8.1 | 1,196 | 11/16/2020 |
0.8.0 | 18,840 | 3/11/2020 |
0.8.0-rc2 | 411 | 3/10/2020 |
0.8.0-rc1 | 431 | 3/3/2020 |
0.7.1 | 1,075 | 3/3/2020 |
0.7.0 | 8,079 | 10/3/2019 |
0.6.3 | 3,278 | 7/30/2019 |
0.6.2 | 1,778 | 6/19/2019 |
0.6.1 | 2,485 | 5/19/2019 |
0.6.0 | 885 | 5/9/2019 |
0.5.0 | 1,365 | 3/6/2019 |
0.4.1 | 853 | 12/7/2018 |
0.4.1-beta351 | 589 | 12/7/2018 |
0.4.0 | 791 | 11/27/2018 |
0.3.3 | 737 | 11/27/2018 |
Petabridge.Cmd v1.0.0 is a major release of Petabridge.Cmd that doesn't include any breaking changes for older clients.
Programmatic `IPbmClient` Support**
It is now possible to invoke Petabridge.Cmd programmatically, as of Petabridge.Cmd 1.0.0 - and this can be done in one of two ways:
1. In-process, inside the same Akka.NET `ActorSystem` that is running the `PetabridgeCmd` host;
2. Remotely, from an external process that connects to the `PetabridgeCmd` host using the same TCP port used by the `pbm` CLI clients.
We've added [extensive documentation to the Petabridge.Cmd website which documents how to use these new `IPbmClient` implementations](https://cmd.petabridge.com/articles/clients/index.html#ipbmclient-programmatic-client), but we've also included a small example here:
```csharp
// <configureHost>
// create a Petabridge.Cmd host from our ActorSystem
// host is configured to run on port 11555 via HOCON
var pbmHost = PetabridgeCmd.Get(Sys);
// start the host
pbmHost.Start();
// </configureHost>
// <clientActorSystem>
// create client ActorSystem
using ActorSystem clientSystem = ActorSystem.Create("ClientSystem");
// grab copy of the PetabridgeCmdClient extension (Petabridge.Cmd.Common NuGet package)
var clientExt = PetabridgeCmdClient.Get(clientSystem);
// create IpEndPoint or DnsEndPoint for contacting remote host
// either one of these would work
var ip = new IPEndPoint(IPAddress.Loopback, 11555);
var dns = new DnsEndPoint("localhost", 11555);
// start a new IPbmClient attached to one of these EndPoints
// by default this operation will time out in 5 seconds.
// you can extend that by passing in a custom CancellationToken
IPbmClient remoteClient = await clientExt.StartRemoteClient(ip);
// </clientActorSystem>
// <runClient>
// invoke a "log peek" command, just like you would on CLI
CommandSession session = await remoteClient.ExecuteTextCommandAsync("log peek");
// grab a hold of the Akka.Streams materializer from ActorSystem
var materializer = Sys.Materializer();
// pipe the Akka.Streams Source<CommandResponse> to a Sink<CommandResponse>
// in this case, we're just going to send everything to a TestActor.
//
// This Akka.Streams "graph" can be materialized into a Task, which will
// complete once the stream is marked as complete by the Petabridge.Cmd host.
var completionTask = session.Stream.RunForeach(rsp =>
{
TestActor.Tell(rsp);
}, materializer);
// a client can also cancel the stream using the KillSwitch included
// inside the CommandSession object
session.KillSwitch.Shutdown();
// once either of those two events occur, the Task returned earlier
// will be complete
await completionTask;
// and we can validate that the TestActor received at least one CommandResponse
var response = ExpectMsg<CommandResponse>();
// </runClient>
```
Multiple Concurrent Client Sessions**
Another major architectural change we've introduced to Petabridge.Cmd in order to support programmatic clients is the notion of multiple client-facing sessions all originating from the same connection. Petabridge.Cmd now effectively supports command multi-plexing on the server and client side.
In effect, a single `IPbmClient` can now run multiple streaming commands at once - such as `log tail`, `cluster tail`, and `remote tail`, all over the same TCP connection.
This is a minor breaking change to some command palettes - all of the official Petabridge ones will be updated shortly to support this, but user-defined `CommandPalette`s may also need to be updated in order to support this. We will update our "[Creating Custom Commands](https://cmd.petabridge.com/articles/commands/custom-commands.html)" documentation shortly to help developers implement these changes successfully - the changes required are minor.