@heroku/plugin-compute 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/LICENSE.txt +207 -0
  2. package/README.md +93 -0
  3. package/lib/commands/compute/config/get.d.ts +19 -0
  4. package/lib/commands/compute/config/get.js +76 -0
  5. package/lib/commands/compute/config/get.js.map +1 -0
  6. package/lib/commands/compute/config/list.d.ts +16 -0
  7. package/lib/commands/compute/config/list.js +57 -0
  8. package/lib/commands/compute/config/list.js.map +1 -0
  9. package/lib/commands/compute/config/set.d.ts +20 -0
  10. package/lib/commands/compute/config/set.js +99 -0
  11. package/lib/commands/compute/config/set.js.map +1 -0
  12. package/lib/commands/compute/config/unset.d.ts +20 -0
  13. package/lib/commands/compute/config/unset.js +93 -0
  14. package/lib/commands/compute/config/unset.js.map +1 -0
  15. package/lib/commands/compute/deploy.d.ts +18 -0
  16. package/lib/commands/compute/deploy.js +95 -0
  17. package/lib/commands/compute/deploy.js.map +1 -0
  18. package/lib/commands/compute/display.d.ts +26 -0
  19. package/lib/commands/compute/display.js +188 -0
  20. package/lib/commands/compute/display.js.map +1 -0
  21. package/lib/commands/compute/generate.d.ts +21 -0
  22. package/lib/commands/compute/generate.js +174 -0
  23. package/lib/commands/compute/generate.js.map +1 -0
  24. package/lib/commands/compute/get/build-log.d.ts +17 -0
  25. package/lib/commands/compute/get/build-log.js +62 -0
  26. package/lib/commands/compute/get/build-log.js.map +1 -0
  27. package/lib/commands/compute/get/runtime-log.d.ts +17 -0
  28. package/lib/commands/compute/get/runtime-log.js +79 -0
  29. package/lib/commands/compute/get/runtime-log.js.map +1 -0
  30. package/lib/commands/compute/list.d.ts +13 -0
  31. package/lib/commands/compute/list.js +55 -0
  32. package/lib/commands/compute/list.js.map +1 -0
  33. package/lib/commands/compute/scale.d.ts +23 -0
  34. package/lib/commands/compute/scale.js +112 -0
  35. package/lib/commands/compute/scale.js.map +1 -0
  36. package/lib/commands/compute/source/retrieve.d.ts +18 -0
  37. package/lib/commands/compute/source/retrieve.js +71 -0
  38. package/lib/commands/compute/source/retrieve.js.map +1 -0
  39. package/lib/commands/compute/tail/runtime-log.d.ts +17 -0
  40. package/lib/commands/compute/tail/runtime-log.js +82 -0
  41. package/lib/commands/compute/tail/runtime-log.js.map +1 -0
  42. package/lib/index.d.ts +2 -0
  43. package/lib/index.js +20 -0
  44. package/lib/index.js.map +1 -0
  45. package/lib/shared/computeApp.d.ts +10 -0
  46. package/lib/shared/computeApp.js +82 -0
  47. package/lib/shared/computeApp.js.map +1 -0
  48. package/lib/shared/computeBundle.d.ts +9 -0
  49. package/lib/shared/computeBundle.js +202 -0
  50. package/lib/shared/computeBundle.js.map +1 -0
  51. package/lib/shared/computeConfig.d.ts +2 -0
  52. package/lib/shared/computeConfig.js +37 -0
  53. package/lib/shared/computeConfig.js.map +1 -0
  54. package/lib/shared/computeConnectApi.d.ts +16 -0
  55. package/lib/shared/computeConnectApi.js +59 -0
  56. package/lib/shared/computeConnectApi.js.map +1 -0
  57. package/lib/shared/computeGenerateSkeletons.d.ts +2 -0
  58. package/lib/shared/computeGenerateSkeletons.js +262 -0
  59. package/lib/shared/computeGenerateSkeletons.js.map +1 -0
  60. package/lib/shared/computeGenerateSource.d.ts +8 -0
  61. package/lib/shared/computeGenerateSource.js +120 -0
  62. package/lib/shared/computeGenerateSource.js.map +1 -0
  63. package/lib/shared/computeLogStream.d.ts +4 -0
  64. package/lib/shared/computeLogStream.js +108 -0
  65. package/lib/shared/computeLogStream.js.map +1 -0
  66. package/lib/shared/computeQuery.d.ts +52 -0
  67. package/lib/shared/computeQuery.js +168 -0
  68. package/lib/shared/computeQuery.js.map +1 -0
  69. package/lib/shared/computeTelemetryDrain.d.ts +11 -0
  70. package/lib/shared/computeTelemetryDrain.js +78 -0
  71. package/lib/shared/computeTelemetryDrain.js.map +1 -0
  72. package/lib/shared/herokuProxyApi.d.ts +62 -0
  73. package/lib/shared/herokuProxyApi.js +243 -0
  74. package/lib/shared/herokuProxyApi.js.map +1 -0
  75. package/lib/shared/metadataApiVersion.d.ts +2 -0
  76. package/lib/shared/metadataApiVersion.js +25 -0
  77. package/lib/shared/metadataApiVersion.js.map +1 -0
  78. package/lib/shared/metadataDeploy.d.ts +5 -0
  79. package/lib/shared/metadataDeploy.js +90 -0
  80. package/lib/shared/metadataDeploy.js.map +1 -0
  81. package/lib/shared/metadataRetrieve.d.ts +2 -0
  82. package/lib/shared/metadataRetrieve.js +68 -0
  83. package/lib/shared/metadataRetrieve.js.map +1 -0
  84. package/lib/shared/plugin-name.d.ts +13 -0
  85. package/lib/shared/plugin-name.js +29 -0
  86. package/lib/shared/plugin-name.js.map +1 -0
  87. package/messages/compute.config.get.md +39 -0
  88. package/messages/compute.config.list.md +24 -0
  89. package/messages/compute.config.set.md +49 -0
  90. package/messages/compute.config.unset.md +39 -0
  91. package/messages/compute.deploy.md +84 -0
  92. package/messages/compute.display.md +46 -0
  93. package/messages/compute.errors.md +182 -0
  94. package/messages/compute.generate.md +74 -0
  95. package/messages/compute.get.build-log.md +36 -0
  96. package/messages/compute.get.runtime-log.md +46 -0
  97. package/messages/compute.list.md +23 -0
  98. package/messages/compute.scale.md +67 -0
  99. package/messages/compute.source.retrieve.md +59 -0
  100. package/messages/compute.tail.runtime-log.md +55 -0
  101. package/npm-shrinkwrap.json +16162 -0
  102. package/oclif.manifest.json +982 -0
  103. package/package.json +117 -0
  104. package/schemas/compute-config-get.json +25 -0
  105. package/schemas/compute-config-list.json +25 -0
  106. package/schemas/compute-config-set.json +28 -0
  107. package/schemas/compute-config-unset.json +28 -0
  108. package/schemas/compute-deploy.json +30 -0
  109. package/schemas/compute-display.json +138 -0
  110. package/schemas/compute-generate.json +40 -0
  111. package/schemas/compute-get-build__log.json +30 -0
  112. package/schemas/compute-get-runtime__log.json +24 -0
  113. package/schemas/compute-list.json +94 -0
  114. package/schemas/compute-scale.json +41 -0
  115. package/schemas/compute-source-retrieve.json +26 -0
  116. package/schemas/compute-tail-runtime__log.json +18 -0
@@ -0,0 +1,182 @@
1
+ # error.invalidName
2
+
3
+ The name "%s" isn't valid. Use only letters, numbers, and underscores, start with a letter, and
4
+ don't use two consecutive underscores. For a namespace-qualified name
5
+ (<namespace>\_\_<developerName>), both parts must independently follow those rules, and the
6
+ namespace must be 15 characters or fewer.
7
+
8
+ # error.cannotResolveAppName
9
+
10
+ Couldn't determine which compute app to use.
11
+
12
+ # error.cannotResolveAppName.actions
13
+
14
+ - Pass --name explicitly.
15
+ - Set the COMPUTE_APP_NAME environment variable.
16
+ - cd into the compute app's own directory (the one with its <name>.compute-meta.xml file) and run the command again.
17
+
18
+ # error.connectApiRequestFailed
19
+
20
+ Couldn't reach the Salesforce Connect API: %s
21
+
22
+ # error.connectApiRequestFailed.actions
23
+
24
+ - Confirm the target org has compute apps enabled and that you have the DeployCompute or ManageCompute permission.
25
+ - Run the command again; if it still fails, check Setup for outstanding compute app errors.
26
+
27
+ # error.metadataDeployFailed
28
+
29
+ Couldn't deploy metadata for compute app %s: %s
30
+
31
+ # error.metadataDeployFailed.actions
32
+
33
+ - Check the error detail above for the specific component failure.
34
+ - Fix the issue and run the deploy again.
35
+
36
+ # error.appNotFoundInOrg
37
+
38
+ No compute app named %s was found in the org. It may not have been deployed yet, or it was deployed under a different name.
39
+
40
+ # error.appNotFoundInOrg.actions
41
+
42
+ - cd into the compute app's directory and run sf compute deploy --target-org <org> to deploy it.
43
+ - Check that the app's directory name matches the DeveloperName used when it was deployed.
44
+
45
+ # error.ambiguousName
46
+
47
+ Found more than one compute app named %s in the org.
48
+
49
+ # error.ambiguousName.actions
50
+
51
+ - This isn't expected; contact your Salesforce admin.
52
+
53
+ # error.queryFailed
54
+
55
+ Couldn't query compute app details: %s
56
+
57
+ # error.queryFailed.actions
58
+
59
+ - Confirm the target org has compute apps enabled and that you have the DeployCompute or ManageCompute permission.
60
+ - Run the command again; if it still fails, check Setup for outstanding compute app errors.
61
+
62
+ # error.buildOutputFetchFailed
63
+
64
+ Couldn't fetch build output: %s
65
+
66
+ # error.buildOutputFetchFailed.actions
67
+
68
+ - Confirm the target org has compute apps enabled and that you have the DeployCompute or ManageCompute permission.
69
+ - Run the command again; if it still fails, check Setup for outstanding compute app errors.
70
+
71
+ # error.logStreamFailed
72
+
73
+ Couldn't read the log stream: %s
74
+
75
+ # error.logStreamFailed.actions
76
+
77
+ - Run the command again; the log session may have expired.
78
+ - If the problem persists, check your network connection to logplex.heroku.com.
79
+
80
+ # error.herokuAppNotFound
81
+
82
+ Heroku didn't find an app named %s.
83
+
84
+ # error.herokuAppNotFound.actions
85
+
86
+ - Confirm the compute app's DeveloperName matches its actual Heroku app name.
87
+ - Run the command again; if it still fails, check Setup for outstanding compute app errors.
88
+
89
+ # error.herokuApiRequestFailed
90
+
91
+ Couldn't reach the Heroku Platform API through Salesforce: %s
92
+
93
+ # error.herokuApiRequestFailed.actions
94
+
95
+ - Run the command again; if it still fails, check Heroku's status page.
96
+ - Confirm the target org has compute apps enabled and that you have the DeployCompute or ManageCompute permission.
97
+
98
+ # error.herokuProxyRequestFailed
99
+
100
+ The Salesforce Heroku API proxy rejected the request: %s
101
+
102
+ # error.herokuProxyRequestFailed.actions
103
+
104
+ - Confirm the target org supports the Heroku API proxy (API version 68.0 or later).
105
+ - Run the command again; if it still fails, check Setup for outstanding compute app errors.
106
+
107
+ # error.herokuFormationNotFound
108
+
109
+ Heroku didn't find app %s or its %s process type.
110
+
111
+ # error.herokuFormationNotFound.actions
112
+
113
+ - Confirm the process type is correct.
114
+ - Run the command again; if it still fails, check Setup for outstanding compute app errors.
115
+
116
+ # error.herokuAppIdentifierUnavailable
117
+
118
+ Compute app %s doesn't have a Heroku app identifier yet.
119
+
120
+ # error.herokuAppIdentifierUnavailable.actions
121
+
122
+ - Wait for the app's current build to finish, then run the command again.
123
+ - If the app has never had a successful build, run sf compute deploy first.
124
+
125
+ # error.configVarNotFound
126
+
127
+ %s has no config var named "%s".
128
+
129
+ # error.configVarNotFound.actions
130
+
131
+ - Run sf compute config list --name <name> --target-org <org> to see the app's current config vars.
132
+
133
+ # error.metadataRetrieveFailed
134
+
135
+ Couldn't retrieve metadata for compute app %s: %s
136
+
137
+ # error.metadataRetrieveFailed.actions
138
+
139
+ - Confirm the app has been deployed to this org (run sf compute deploy first).
140
+ - Check that --name matches the DeveloperName used when it was deployed.
141
+
142
+ # error.sourceDownloadFailed
143
+
144
+ Couldn't download the compute app's source: %s
145
+
146
+ # error.sourceDownloadFailed.actions
147
+
148
+ - Confirm the target org has compute apps enabled and that you have the DeployCompute or ManageCompute permission.
149
+ - Confirm the app has been deployed to this org (run sf compute deploy first).
150
+
151
+ # error.sourceBundleMalformed
152
+
153
+ The downloaded deployment bundle is invalid: %s.
154
+
155
+ # error.sourceBundleMalformed.actions
156
+
157
+ - Run sf compute source retrieve again; if it still fails, contact your Salesforce admin.
158
+
159
+ # error.templateSourceFetchFailed
160
+
161
+ Couldn't fetch the %s starter source: %s
162
+
163
+ # error.templateSourceFetchFailed.actions
164
+
165
+ - Check your network connection to github.com and codeload.github.com.
166
+ - Run the command again; if it still fails, check https://www.githubstatus.com.
167
+
168
+ # error.templateSourceChecksumMismatch
169
+
170
+ The %s starter source didn't match its expected checksum (expected %s, got %s).
171
+
172
+ # error.templateSourceChecksumMismatch.actions
173
+
174
+ - Run the command again; if it still fails, this plugin's pinned reference commit may need updating.
175
+
176
+ # error.templateSourceMalformed
177
+
178
+ The %s starter source download is invalid: %s.
179
+
180
+ # error.templateSourceMalformed.actions
181
+
182
+ - Run the command again; if it still fails, this plugin's pinned reference commit may need updating.
@@ -0,0 +1,74 @@
1
+ # summary
2
+
3
+ Scaffold a new compute app into your Salesforce DX project.
4
+
5
+ # description
6
+
7
+ Creates the app directory under force-app/main/default/platformComputeApps/<name>/ (or
8
+ --output-dir) with a compute metadata file, a Procfile, a project.toml, and
9
+ starter source in the language you choose with --language. No org is
10
+ contacted, but this command does fetch the starter source for the chosen
11
+ language from its Heroku AppLink reference app on GitHub, so it requires
12
+ outbound network access.
13
+
14
+ # flags.name.summary
15
+
16
+ Name for the new compute app. Use <namespace>\_\_<developerName> to scaffold
17
+ it under a namespace.
18
+
19
+ # flags.output-dir.summary
20
+
21
+ Directory to create the app in.
22
+
23
+ # flags.output-dir.description
24
+
25
+ Defaults to force-app/main/default/platformComputeApps. The app itself is created in a
26
+ subdirectory named after --name.
27
+
28
+ # flags.language.summary
29
+
30
+ Language to scaffold the starter project in.
31
+
32
+ # flags.language.description
33
+
34
+ Compute apps can run any Heroku-supported language, but generate currently
35
+ scaffolds starters for node and python only.
36
+
37
+ # examples
38
+
39
+ - Scaffold a Node.js compute app named CreditRatingScorer:
40
+
41
+ <%= config.bin %> <%= command.id %> --name CreditRatingScorer
42
+
43
+ - Scaffold a Python compute app into a custom directory:
44
+
45
+ <%= config.bin %> <%= command.id %> --name ReceiptOcr --language python --output-dir force-app/main/default/platformComputeApps/scorers
46
+
47
+ # error.appAlreadyExists
48
+
49
+ A compute app named %s already exists at %s. Choose a different name or remove the existing directory.
50
+
51
+ # error.appAlreadyExists.actions
52
+
53
+ - Choose a different --name.
54
+ - Remove the existing directory and run this command again.
55
+
56
+ # error.templateSourceMissingFile
57
+
58
+ The %s starter source is missing an expected file: %s.
59
+
60
+ # error.templateSourceMissingFile.actions
61
+
62
+ - This plugin's pinned reference commit may be out of date with the upstream repo's layout; file an issue against @heroku/plugin-compute.
63
+
64
+ # info.generating
65
+
66
+ Generating compute app %s...
67
+
68
+ # info.created
69
+
70
+ created %s
71
+
72
+ # info.done
73
+
74
+ Created compute app %s.
@@ -0,0 +1,36 @@
1
+ # summary
2
+
3
+ Print the build/compile log for a compute app's latest build.
4
+
5
+ # description
6
+
7
+ Fetches the bounded build/compile log (dependency install, slug compile,
8
+ release) for the most recent build of a compute app -- useful right after
9
+ deploy to confirm the build compiled. This is a one-shot fetch of a
10
+ finished-or-in-progress log, not a live stream; use compute tail runtime-log
11
+ for the ongoing runtime log.
12
+
13
+ This is a read-only, org-mediated lookup by --name (the app's DeveloperName)
14
+ -- the org calls Heroku's Build Info API on your behalf. It doesn't read from
15
+ or require a local Salesforce DX project.
16
+
17
+ # flags.name.summary
18
+
19
+ DeveloperName of the compute app to fetch build output for (or
20
+ <namespace>\_\_<developerName> if it was deployed under a namespace).
21
+ Defaults to the COMPUTE_APP_NAME environment variable, or the current
22
+ directory's app name if that isn't set either.
23
+
24
+ # info.noBuildsFound
25
+
26
+ Compute app %s has no builds yet.
27
+
28
+ # info.buildOutputNotYetAvailable
29
+
30
+ Compute app %s's latest build (%s) hasn't produced output yet. Try again shortly.
31
+
32
+ # examples
33
+
34
+ - Print the latest build's log:
35
+
36
+ <%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org
@@ -0,0 +1,46 @@
1
+ # summary
2
+
3
+ Print the recent runtime log for a compute app.
4
+
5
+ # description
6
+
7
+ Fetches a compute app's runtime log -- the app's ongoing output (request
8
+ handling, application logs), not the build/compile log; use compute get
9
+ build-log for that.
10
+
11
+ This prints the most recent log lines and exits. To keep the session open and
12
+ stream new lines as they arrive, use compute tail runtime-log.
13
+
14
+ This is an org-mediated operation by --name (the app's DeveloperName) -- the
15
+ org creates a log session with Heroku on your behalf and hands back a
16
+ short-lived, pre-authorized URL that the CLI reads from directly. It doesn't
17
+ read from or require a local Salesforce DX project.
18
+
19
+ # flags.name.summary
20
+
21
+ DeveloperName of the compute app to fetch logs for (or
22
+ <namespace>\_\_<developerName> if it was deployed under a namespace).
23
+ Defaults to the COMPUTE_APP_NAME environment variable, or the current
24
+ directory's app name if that isn't set either.
25
+
26
+ # flags.num.summary
27
+
28
+ Number of recent log lines to print.
29
+
30
+ # info.noBuildsFound
31
+
32
+ Compute app %s has no builds yet, so it has no logs.
33
+
34
+ # info.noLogLines
35
+
36
+ Compute app %s has no log output yet.
37
+
38
+ # examples
39
+
40
+ - Print the most recent log lines:
41
+
42
+ <%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org
43
+
44
+ - Print the most recent 500 log lines:
45
+
46
+ <%= config.bin %> <%= command.id %> --name CreditRatingScorer --num 500 --target-org my-org
@@ -0,0 +1,23 @@
1
+ # summary
2
+
3
+ List the compute apps deployed in an org.
4
+
5
+ # description
6
+
7
+ Queries the org for every compute app (PlatformComputeApp). The table shows
8
+ each app's master label, status, and status reason; for description, external
9
+ service registration, and current build detail on a single app, use compute
10
+ display (the full detail is also available here via --json).
11
+
12
+ This is a read-only, live lookup -- it doesn't read from or require a local
13
+ Salesforce DX project.
14
+
15
+ # info.noAppsFound
16
+
17
+ No compute apps were found in the org.
18
+
19
+ # examples
20
+
21
+ - List the compute apps in an org:
22
+
23
+ <%= config.bin %> <%= command.id %> --target-org my-org
@@ -0,0 +1,67 @@
1
+ # summary
2
+
3
+ Resize or rescale a compute app's dyno formation.
4
+
5
+ # description
6
+
7
+ Updates a single process type's dyno size and/or quantity for a deployed
8
+ compute app. Pass the process type with --process-type and at least one of
9
+ --quantity or --size. This goes through the target org's Salesforce Connect
10
+ API, which calls Heroku on your behalf.
11
+
12
+ # flags.process-type.summary
13
+
14
+ Process type to scale, for example web or worker.
15
+
16
+ # flags.quantity.summary
17
+
18
+ Number of dynos to run for the process type (0 stops all dynos of that type).
19
+
20
+ # flags.size.summary
21
+
22
+ Dyno size to run the process type on, for example dyno-1c-4gb.
23
+
24
+ # flags.name.summary
25
+
26
+ DeveloperName of the compute app to scale (or <namespace>\_\_<developerName>
27
+ if it was deployed under a namespace). Defaults to the COMPUTE_APP_NAME
28
+ environment variable, or the current directory's app name if that isn't set
29
+ either.
30
+
31
+ # examples
32
+
33
+ - Change a process type's dyno size:
34
+
35
+ <%= config.bin %> <%= command.id %> --process-type web --size dyno-2c-8gb --name CreditRatingScorer --target-org my-org
36
+
37
+ - Scale a process type's dyno count:
38
+
39
+ <%= config.bin %> <%= command.id %> --process-type worker --quantity 3 --name CreditRatingScorer --target-org my-org
40
+
41
+ - Change size and quantity together:
42
+
43
+ <%= config.bin %> <%= command.id %> --process-type web --quantity 2 --size dyno-4c-16gb --name CreditRatingScorer --target-org my-org
44
+
45
+ - Stop all dynos of a process type:
46
+
47
+ <%= config.bin %> <%= command.id %> --process-type worker --quantity 0 --name CreditRatingScorer --target-org my-org
48
+
49
+ # error.scaleInvalidProcessType
50
+
51
+ "%s" isn't a valid process type.
52
+
53
+ # error.scaleInvalidProcessType.actions
54
+
55
+ - Use a process type made up of letters, numbers, hyphens, or underscores, for example web or worker.
56
+
57
+ # error.scaleNoChange
58
+
59
+ Specify a quantity and/or size to scale "%s" to.
60
+
61
+ # error.scaleNoChange.actions
62
+
63
+ - Add --quantity, --size, or both, for example --quantity 2 or --size dyno-1c-4gb.
64
+
65
+ # error.scaleInvalidSize
66
+
67
+ "%s" is not a valid size. Valid sizes: %s.
@@ -0,0 +1,59 @@
1
+ # summary
2
+
3
+ Retrieve a compute app's source and metadata from an org into your local Salesforce DX project.
4
+
5
+ # description
6
+
7
+ Creates the compute app's directory under force-app/main/default/platformComputeApps/<name>/
8
+ (or --output-dir), retrieves its <name>.compute-meta.xml through the Metadata
9
+ API, then downloads its source code through the Connect API and extracts it
10
+ into that same directory. This is the inverse of sf compute deploy.
11
+
12
+ # flags.name.summary
13
+
14
+ DeveloperName of the compute app to retrieve (or <namespace>\_\_<developerName>
15
+ if it was deployed under a namespace).
16
+
17
+ # flags.output-dir.summary
18
+
19
+ Directory to create the app in.
20
+
21
+ # flags.output-dir.description
22
+
23
+ Defaults to force-app/main/default/platformComputeApps. The app itself is created in a
24
+ subdirectory named after --name.
25
+
26
+ # examples
27
+
28
+ - Retrieve a compute app's source and metadata from an org:
29
+
30
+ <%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org
31
+
32
+ # error.appAlreadyExists
33
+
34
+ A directory named %s already exists at %s. Choose a different --output-dir, or remove the existing directory and run this command again.
35
+
36
+ # error.appAlreadyExists.actions
37
+
38
+ - Choose a different --output-dir.
39
+ - Remove the existing directory and run this command again.
40
+
41
+ # info.retrieving
42
+
43
+ Retrieving compute app %s from %s...
44
+
45
+ # info.retrievedMetadata
46
+
47
+ retrieved %s
48
+
49
+ # info.downloadingSource
50
+
51
+ Downloading source...
52
+
53
+ # info.extractedSource
54
+
55
+ extracted %s files
56
+
57
+ # info.done
58
+
59
+ Retrieved compute app %s into %s.
@@ -0,0 +1,55 @@
1
+ # summary
2
+
3
+ Stream the live runtime log for a compute app.
4
+
5
+ # description
6
+
7
+ Streams a compute app's runtime log -- the app's ongoing output (request
8
+ handling, application logs), not the build/compile log; use compute get
9
+ build-log for that.
10
+
11
+ Keeps the session open and prints new log lines as they arrive, until you stop
12
+ it with Ctrl-C or the session ends on its own. For a one-time snapshot of the
13
+ most recent lines, use compute get runtime-log.
14
+
15
+ This is an org-mediated operation by --name (the app's DeveloperName) -- the
16
+ org creates a log session with Heroku on your behalf and hands back a
17
+ short-lived, pre-authorized URL that the CLI reads from directly. It doesn't
18
+ read from or require a local Salesforce DX project.
19
+
20
+ # flags.name.summary
21
+
22
+ DeveloperName of the compute app to tail logs for (or
23
+ <namespace>\_\_<developerName> if it was deployed under a namespace).
24
+ Defaults to the COMPUTE_APP_NAME environment variable, or the current
25
+ directory's app name if that isn't set either.
26
+
27
+ # flags.num.summary
28
+
29
+ Number of recent log lines to print before streaming new output.
30
+
31
+ # info.noBuildsFound
32
+
33
+ Compute app %s has no builds yet, so it has no logs.
34
+
35
+ # info.tailStarting
36
+
37
+ Tailing logs for %s. Press Ctrl-C to stop.
38
+
39
+ # info.tailStopped
40
+
41
+ Stopped tailing %s.
42
+
43
+ # info.tailStreamEnded
44
+
45
+ The log session for %s ended.
46
+
47
+ # examples
48
+
49
+ - Tail the log until stopped with Ctrl-C:
50
+
51
+ <%= config.bin %> <%= command.id %> --name CreditRatingScorer --target-org my-org
52
+
53
+ - Print the most recent 500 lines, then keep streaming:
54
+
55
+ <%= config.bin %> <%= command.id %> --name CreditRatingScorer --num 500 --target-org my-org