@@ -800,15 +800,27 @@ Commands:
800
800
` ` `
801
801
802
802
To build a specific content item, first ` add` it to the list of content that is
803
- " tracked" for building using its GUID.
803
+ " tracked" for building using its GUID. Content that is " tracked" in the local state
804
+ may become out-of-sync with what exists remotely on the Connect server (the result of
805
+ ` rsconnect content search` ). When this happens, it is safe to remove the locally tracked
806
+ entries with ` rsconnect content build rm` .
804
807
805
808
> ** Note**
806
809
> Metadata for " tracked" content items is stored in a local directory called
807
810
> ` rsconnect-build` which will be automatically created in your current working directory.
808
811
> You may set the environment variable ` CONNECT_CONTENT_BUILD_DIR` to override this directory location.
809
812
810
813
` ` ` bash
814
+ # `add` the content to mark it as "tracked"
811
815
rsconnect content build add --guid 4ffc819c-065c-420c-88eb-332db1133317
816
+
817
+ # run the build which kicks off a cache rebuild on the server
818
+ rsconnect content build run
819
+
820
+ # once the build is complete, the content can be "untracked"
821
+ # this does not remove the content from the Connect server
822
+ # the entry is only removed from the local state file
823
+ rsconnect content build rm --guid 4ffc819c-065c-420c-88eb-332db1133317
812
824
` ` `
813
825
814
826
> ** Note**
@@ -891,6 +903,15 @@ rsconnect content build logs --guid 4ffc819c-065c-420c-88eb-332db1133317
891
903
# Task failed. Task exited with status 1.
892
904
` ` `
893
905
906
+ Once a build for a piece of tracked content is complete, it can be safely removed from the list of " tracked"
907
+ content by using ` rsconnect content build rm` command. This command accepts a ` --guid` argument to specify
908
+ which piece of content to remove. Removing the content from the list of tracked content simply removes the item
909
+ from the local state file, the content deployed to the server remains unchanged.
910
+
911
+ ` ` ` bash
912
+ rsconnect content build rm --guid 4ffc819c-065c-420c-88eb-332db1133317
913
+ ` ` `
914
+
894
915
# # Common Usage Examples
895
916
896
917
# ## Searching for content
0 commit comments