Cloudera Manager Parcels
========================

.. raw:: html

    <p>Anaconda Repository provides a way to integrate with Cloudera Manager to
    distribute your Anaconda data science artifacts to your Hadoop cluster.
    You can create custom parcels with the packages <em>you</em> want, including your
    own packages.</p>
    <p>NOTE: Creating custom parcels requires a local mirror of the Anaconda packages.
    Anaconda Repository will not connect to <code class="docutils literal"><span class="pre">http://repo.continuum.io</span></code> to fetch
    packages that are not available locally. See the
    <a class="reference internal" href="../admin/mirrors-anaconda-repository.html#mirroring-an-anaconda-repository"><span class="std std-ref">mirroring documentation</span></a>.</p>
    <p>To create a custom parcel, navigate to <code class="docutils literal"><span class="pre">/&lt;username&gt;/installers</span></code>. You can
    find this link in the dropdown menu, or in the <strong>Installers</strong> card on your
    homepage.</p>
    <p>Now select the &#8220;Create new installer&#8221; button. This brings you to a package selection form.
    You can select which accounts to fetch packages from - the <code class="docutils literal"><span class="pre">anaconda</span></code> user will be added
    by default. After an account is selected, package names can be entered into the package
    field.</p>
    <p>When creating a parcel, Anaconda Repository
    generates a file named <code class="docutils literal"><span class="pre">construct.yaml</span></code> which can be used with
    <a class="reference external" href="https://github.com/conda/constructor">conda constructor</a>, and a 64-bit Linux
    installer including the specified packages. To create just the installer script,
    click <strong>Create installer</strong>; to create a parcel, click <strong>Create parcel</strong>.</p>
    <p>NOTE: By default, conda is not included in the custom parcel. If you wish to
    add additional packages to your environment, you can add those through the
    Anaconda Repository interface. If you wish to see the list of packages that
    are included in your custom parcel, the information is provided in
    <code class="docutils literal"><span class="pre">/opt/cloudera/parcels/&lt;PARCEL_NAME&gt;/meta/parcel.json</span></code>.</p>
    <p>NOTE: The parcel is generated with the prefix of <code class="docutils literal"><span class="pre">/opt/cloudera/parcels/&lt;PARCEL_NAME&gt;</span></code>.
    This is the default location where activated parcels are loaded. If you are deploying parcels
    in a different directory, you can change this prefix with the <code class="docutils literal"><span class="pre">PARCELS_ROOT</span></code>
    <a class="reference internal" href="../admin/reference.html#parcels-root"><span class="std std-ref">configuration setting</span></a>.</p>
    <p>Once you have created a custom parcel, you can distribute it to your
    cluster by adding <code class="docutils literal"><span class="pre">http://&lt;repository</span> <span class="pre">ip&gt;:&lt;port&gt;/&lt;username&gt;/installers/parcels/</span></code> as a
    <a class="reference external" href="https://www.cloudera.com/documentation/enterprise/latest/topics/cm_ig_create_local_parcel_repo.html#concept_yxz_bxt_vm">Remote Parcel Repository URL</a>.
    Cloudera Manager will detect the parcels hosted on Anaconda Repository, and provide the
    option to <strong>Download</strong> and <strong>Distribute</strong> the parcels.</p>
    <p>By default, Anaconda Repository generates a parcel file for every
    <a class="reference external" href="https://github.com/cloudera/cm_ext/wiki/Parcel-distro-suffixes">compatible distribution</a>.
    You can customize which parcel distributions are created by configuring the <code class="docutils literal"><span class="pre">PARCEL_DISTRO_SUFFIXES</span></code>
    <a class="reference internal" href="../admin/reference.html#parcel-distro-suffixes"><span class="std std-ref">configuration setting</span></a>.</p>
