Skip to content

Commit 26d5acb

Browse files
authored
Document the parallelism content build setting (#616)
1 parent 4ffef39 commit 26d5acb

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -912,6 +912,22 @@ from the local state file, the content deployed to the server remains unchanged.
912912
rsconnect content build rm --guid 4ffc819c-065c-420c-88eb-332db1133317
913913
```
914914
915+
### Rebuilding lots of content
916+
917+
When attempting to rebuild a long list of content, it is recommended to first build a sub-set of the content list.
918+
First choose 1 or 2 Python and R content items for each version of Python and R on the server. Try to choose content
919+
items that have the most dependencies in common with other content items on the server. Build these content items
920+
first with the `rsconnect content build run` command. This will "warm" the Python and R environment cache for subsequent
921+
content builds. Once these initial builds are complete, add the remaining content items to the list of "tracked" content
922+
and execute another `rsconnect content build run` command.
923+
924+
To execute multiple content builds simultaniously, use the `rsconnect content build run --parallelism` flag to increase the
925+
number of concurrent builds. By default, each content item is built serially. Increasing the build parallelism can reduce the total
926+
time needed to rebuild a long list of content items. We recommend starting with a low parallelism setting (2-3) and increasing
927+
from there to avoid overloading the Connect server with concurrent build operations. Remember that these builds are executing on the
928+
Connect server which consumes CPU, RAM, and i/o bandwidth that would otherwise we allocated for Python and R applications
929+
running on the server.
930+
915931
## Common Usage Examples
916932
917933
### Searching for content

0 commit comments

Comments
 (0)