PerlAppResourceBuilderExtensions
Classstaticnet10.0
Extension methods for adding Perl application resources to the application model.
namespace Aspire.Hosting;
public static class PerlAppResourceBuilderExtensions{ // ...}12 members
Methods12
Section titled MethodsIResourceBuilder<PerlAppResource> Adds a Perl API server resource (e.g., Mojolicious, Dancer2) to the application model. Passes the
daemon subcommand so HTTP frameworks start a listener. IResourceBuilder<PerlAppResource> Adds a Perl executable (compiled binary or PAR-packed application) to the application model. The executable is run directly rather than through the
perl interpreter. IResourceBuilder<PerlAppResource> Adds a Perl module to the application model. The module is executed using
perl -MModule::Name -e "Module::Name->run()" . IResourceBuilder<PerlAppResource> Adds a Perl script resource (worker, CLI tool, background service) to the application model.
IResourceBuilder<TResource> Configures the Perl application to use Carton as its package manager. Carton manages dependencies via
cpanfile and a lock file ( cpanfile.snapshot ), enabling reproducible builds. Use PerlAppResourceBuilderExtensions.WithProjectDependencies to run carton install at startup. IResourceBuilder<TResource> Configures the Perl application to use cpanm (App::cpanminus) as its package manager instead of the default cpan. Call this before
PerlAppResourceBuilderExtensions.WithPackage to change how packages are installed. IResourceBuilder<TResource> Configures the Perl application to use a local::lib directory for module isolation. Sets
PERL5LIB , PERL_LOCAL_LIB_ROOT , PERL_MM_OPT , and PERL_MB_OPT environment variables so that modules are resolved from and installed into the local directory. IResourceBuilder<TResource> Adds a Perl package (module) to be installed before the application starts. Uses the configured package manager: cpan by default, or cpanm if
PerlAppResourceBuilderExtensions.WithCpanMinus was called. IResourceBuilder<T> Configures the Perl application to use a specific perlbrew-managed Perl version.
IResourceBuilder<T> Configures the Perl application to use a specific perlbrew-managed Perl version. This resolves the Perl executable from the perlbrew installation and updates the resource's command and environment variables so that all subsequent operations use the specified Perl version.
IResourceBuilder<TResource> Configures certificate trust for the Perl application by setting SSL/TLS environment variables that common Perl HTTP libraries respect. Sets
SSL_CERT_FILE (IO::Socket::SSL / LWP), PERL_LWP_SSL_CA_FILE (LWP::UserAgent), and MOJO_CA_FILE (Mojolicious) to the certificate bundle path provided by Aspire. IResourceBuilder<TResource> Configures project-level dependency installation for the Perl application. Runs the appropriate install command based on the active package manager:
- cpanm:
cpanm -- installdeps - - notest . - carton:
carton install [-- deployment]
cpan (the default), it is automatically switched to cpanm since cpan does not support --installdeps . 
Aspire