Hi,
I have a mishmash of committed and uncommitted files in the umbraco folder, I'm not sure what went wrong.
I have some committed, and some uncomitted files in umbraco/assets/* umbraco/lib/* umbraco/Views/**
I'm guessing last time I upgraded I didn't commit these.....
I have also noticed that when I compile all the uncommitted files get pulled in (from nuget I assume)
I was going to just commit all the files in the umbraco folder, but now I'm wondering if I should exclude certain folders, and let nuget pull them in.
I'm guessing this would reduce the repo size, and make upgrading easier?
You shouldn't need to commit anything from the Umbraco folder. As you've noticed all the relevant files get pulled from Nuget and copied on build. This negates the need for them.
There's also a few other folders that you should ignore also.
Here's a comprehensive list to ignore when using git (You should be able to translate the syntax if using another system).
You could ignore the App_Data\TEMP folder, but if you ignore the entire App_Data folder, you risk losing important data. For example, the packages you have installed are kept in App_Data\packages\created.
Also, some packages store data in that folder (e.g., Formulate stores form definitions and some other info in the App_Data\Formulate folder). Actually, in the case of Formulate, I consider that data to be environment-specific, so I do actually ignore that folder (depends on how you manage data, however).
we treat that kind of data as operating data, the same way we treat media, and don't store it in source control, so that works for us. It's anoying when plugins like umbracoForms stores operating data elsewhere like the App_Plugins folder Grrrr ;-)
FYI, packages sometimes install things in the "Umbraco" folder, so you'll want to watch out for that. Otherwise, I think the entire "Umbraco" folder can be excluded from source control and should be restored by NuGet package restore on build in Visual Studio 2015.
It may actually still necessary for some things (e.g., some tinyMCE customizations, I believe).
Also, it wasn't possible until very recently to add translations in the App_Plugins folder (they were kept somewhere under the umbraco folder). Because the umbraco folder often gets ignored by source control, this sometimes led to translations for things like Contour getting lost.
For anyone stumbling across this post I should clarify that we're talking about Umbraco version 7.4.3
:-)
When ignoring my umbraco folder I did see some contour elements in an english XML file that got lost, ... but I checked the back-office, and I didn't see anything missing. So It seems it should be fine to lose?
(also my to-do list is to upgrade umbracoForms to 4.3.2)
What should I commit in the umbraco folder?
Hi,
I have a mishmash of committed and uncommitted files in the umbraco folder, I'm not sure what went wrong.
I have some committed, and some uncomitted files in umbraco/assets/* umbraco/lib/* umbraco/Views/**
I'm guessing last time I upgraded I didn't commit these.....
I have also noticed that when I compile all the uncommitted files get pulled in (from nuget I assume)
I was going to just commit all the files in the umbraco folder, but now I'm wondering if I should exclude certain folders, and let nuget pull them in. I'm guessing this would reduce the repo size, and make upgrading easier?
What should I do?
Cheers.
Murray
Hi Murray,
You shouldn't need to commit anything from the Umbraco folder. As you've noticed all the relevant files get pulled from Nuget and copied on build. This negates the need for them.
There's also a few other folders that you should ignore also.
Here's a comprehensive list to ignore when using git (You should be able to translate the syntax if using another system).
https://github.com/github/gitignore/blob/master/Umbraco.gitignore
Cheers
James
Thanks... but, the comprehensive list does not seem to ignore /Umbraco/ nor /umbraco_client/ I assume I should add those to my ignore list?
I do not know if SVN is capable of un-ignoring /Umbraco/Developer/Packages/ within an ignored folder?
(NB: I currently don't have anything there other than comes in the nuget package)
Hi Murray,
You're correct; they are missing. Adding the following to the list is definitely wise.
I also ignore the media folder since that is a common cause of bloat.
I don't know what SVN's capabilities are I'm afraid. It's been about 6 years since I last used it.
Cheers
James
ok, cool.
One other question...
Why not ignore the entire App_Data folder?
We've been doing this for a while and not hit any snags.
Cheers.
Murray.
You could ignore the
App_Data\TEMP
folder, but if you ignore the entireApp_Data
folder, you risk losing important data. For example, the packages you have installed are kept inApp_Data\packages\created
.Also, some packages store data in that folder (e.g., Formulate stores form definitions and some other info in the
App_Data\Formulate
folder). Actually, in the case of Formulate, I consider that data to be environment-specific, so I do actually ignore that folder (depends on how you manage data, however).we treat that kind of data as operating data, the same way we treat media, and don't store it in source control, so that works for us. It's anoying when plugins like umbracoForms stores operating data elsewhere like the App_Plugins folder Grrrr ;-)
FYI, packages sometimes install things in the "Umbraco" folder, so you'll want to watch out for that. Otherwise, I think the entire "Umbraco" folder can be excluded from source control and should be restored by NuGet package restore on build in Visual Studio 2015.
Yeah Nicholas, I've noticed that as well - That's a hangover from very old versions I believe.
If I saw a package doing it I would contact the owner and get them to update their approach. The umbraco folder should be an absolute no-go.
It may actually still necessary for some things (e.g., some tinyMCE customizations, I believe).
Also, it wasn't possible until very recently to add translations in the
App_Plugins
folder (they were kept somewhere under theumbraco
folder). Because theumbraco
folder often gets ignored by source control, this sometimes led to translations for things like Contour getting lost.Did not know that about the translations!
For anyone stumbling across this post I should clarify that we're talking about Umbraco version 7.4.3
:-)
When ignoring my umbraco folder I did see some contour elements in an english XML file that got lost, ... but I checked the back-office, and I didn't see anything missing. So It seems it should be fine to lose? (also my to-do list is to upgrade umbracoForms to 4.3.2)
I also added an issue in the documentation website linking here: https://github.com/umbraco/UmbracoDocs/issues/366
is working on a reply...