Your achievements

Level 1

0% to

Level 2

Tip /
Sign in

Sign in to Community

to gain points, level up, and earn exciting badges like the new
Bedrock Mission!

Learn more

View all

Sign in to view all badges

SOLVED

Build Process :: zip archive

SarahEOwen
Level 10
Level 10

In this help article - File Format  - the 2nd paragraph discusses a zip archive (see yellow highlighting in the screen shot below).

When do a build, I am not seeing this option. Where should I be looking to see this functionality?

1280258_pastedImage_0.png

1 Accepted Solution
thebenrobb
Correct answer by
Employee
Employee

A couple things going on here:

  1. There's an implicit assumption that if you are generating an archive, then you are going to download it so that you can deploy it somewhere else, if you were going to use Akamai for hosting, then you wouldn't need an archive.
  2. When you use custom code or 3rd party custom scripts it is possible that Launch will build multiple .js files that have to reference each other.  In order to reference each other, they need to know where they will be hosted. This self-hosted path to Library option is required so that they multiple files can reference each other properly.
  3. And since the assumption is that you're hosting stuff on your own, then as you noted, the embed code changes.

So with all that, if you provide anything in the self-hosted path to library field, you can then save the Environment.  Along with your new embed code, you'll also get a link to the archived download.  Launch will still build your library and deploy it to Akamai, but instead of deploying a bunch of JS files, it will deploy a zip file to Akamai, and you'll download it from assets.adobedtm.com/...

Screen Shot 2017-08-17 at 11.15.00 AM.png

Note, that there won't be anything in that location until you actually make a build, but the idea is that you'll download it from that location on Akamai, and then upload it to your own server in the location that you told us, and your embed code (on your pagE) will attempt to grab it from your own server where you told us it would be.

All that make sense?

View solution in original post

9 Replies
Till_Buettner-8
Level 5
Level 5

Hi Sarah,

the zip archive is build in Environments, if you use Akamai as Adapter:

1280373_pastedImage_0.png

But you can either use Akamai or zip archive not both at the same time.

SarahEOwen
Level 10
Level 10

Thanks, Till! I was doing builds in the Publishing tab today and had it in my head that this was the location the help article was talking about. Thanks for the screen shot -- I heart visuals!

Have a good day -

Sarah

Till_Buettner-8
Level 5
Level 5

You are welcome (and evening/night here now, but the day was good )

SarahEOwen
Level 10
Level 10

Hi thebenrobb​ -

In listening to the West Coast Office Hours from the 8/15 meeting, it sounded like the archived zip file could be found at assets.adobedtm.com (see 1st screen shot -- it is minute 47:15 in the recording).

Yet, when I select "Create archive" I have to provide a "Self-hosted Path to Library" in order to save my Environment (see 2nd screen shot). When I provide this value, then my embed code changes.

I was under the impression I had to go to my "Self-hosted Path to Library" to find the zipped archive file -- though my build/publish will still go to Akamai.

Can you please provide clarification?

Thanks

1st Screen Shot from West Coast Office Hours

1280565_pastedImage_0.png

2nd Screen Shot from my Launch

1280566_pastedImage_1.png

Thanks -

Sarah

thebenrobb
Correct answer by
Employee
Employee

A couple things going on here:

  1. There's an implicit assumption that if you are generating an archive, then you are going to download it so that you can deploy it somewhere else, if you were going to use Akamai for hosting, then you wouldn't need an archive.
  2. When you use custom code or 3rd party custom scripts it is possible that Launch will build multiple .js files that have to reference each other.  In order to reference each other, they need to know where they will be hosted. This self-hosted path to Library option is required so that they multiple files can reference each other properly.
  3. And since the assumption is that you're hosting stuff on your own, then as you noted, the embed code changes.

So with all that, if you provide anything in the self-hosted path to library field, you can then save the Environment.  Along with your new embed code, you'll also get a link to the archived download.  Launch will still build your library and deploy it to Akamai, but instead of deploying a bunch of JS files, it will deploy a zip file to Akamai, and you'll download it from assets.adobedtm.com/...

Screen Shot 2017-08-17 at 11.15.00 AM.png

Note, that there won't be anything in that location until you actually make a build, but the idea is that you'll download it from that location on Akamai, and then upload it to your own server in the location that you told us, and your embed code (on your pagE) will attempt to grab it from your own server where you told us it would be.

All that make sense?

View solution in original post

thebenrobb
Employee
Employee

Also, I've logged an issue to mention that our documentation could use some improvement in this area 😃

--

DTM-10348

SarahEOwen
Level 10
Level 10

Hi thebenrobb​ -

Thanks for the explanation! Yes, it makes sense - I really appreciate you taking the time to go into the detail that you did!

Thanks so much -

Sarah

paragn36103535
Level 3
Level 3

thebenrobb​ I am not able to find archive download option in environment section. Can you please advise.

Also, can you please advise what does 'Include debug library' mean. Does it mean that it will contact both minified and un-minified libraries ?

Can I only download the zip package after the apckage has been approved till production ?

I want to be able to download the zip package after has been created in Development environment or approved in dev. environment . Is that possible ?

thebenrobb
Employee
Employee

Till_Buettner 's screenshot above has a highlight colored over the archive option.  When you create/edit an environment, there's a toggle to create an archive.  If you don't see that on your environments, please let us know the property name/environment name where the archive option isn't showing up (you can also just copy/paste the URL from the environment page) and we'll take a look.

A debug library is an unminified library.  If "Include Debug Library" is on, then unminified builds will be produced and deployed alongside your minified Launch files.  You can find them by removing the ".min" from your embed code URL.

If you create an archive, you can download it as soon as you produce a build.  So if you want to grab it from Dev, just use the archive option on your Dev environment, once you build to Dev, you can go hit the download link on your dev environment to grab the file.