The general workflow is as follows:

    clone.

    ::

    branch is in line with the latest changes from upstream. Then push it to your

    clone so that origin knows about the changes.

    ::

    ::

      $ git commit -s -m "awesome patch to somefile.py"

  * This step is optional but recommended in order to avoid collisions when

    ::

    ::

      ..... Resolve any conflicts if needed ......

  The following is an useful shell function to place in your ``~/.bashrc`` to

  help automate certain aspects of the developer workflow. It will allow you to

  easily keeping in line with the upstream repository.

  The following is the bash function to be added to your ``~/.bashrc`` and make

      pullupstream () {

          if [[ -z "$1" ]]; then

          else

              pullup_startbranch=$(git describe --contains --all HEAD)

              git checkout $1

          fi

      }

  branch even while using a topic branch as follows:

  ::

      On branch docs

      nothing to commit, working directory clean

      Already up-to-date.

      Everything up-to-date

      Switched to branch 'docs'

      nothing to commit, working directory clean

  Now that you're back on your topic branch you can easily rebase on your local

  clean pull request submission.

  ::

      Current branch docs is up to date.

  ::

              'OLPC-2': 'f7',

  and update ``GITBRANCHES`` with the translation from pkgdb branch string to git

      GITBRANCHES = {'EL-4': 'el4', 'EL-5': 'el5', 'EL-6': 'el6', 'OLPC-2': 'olpc2',

                     'FC-6': 'fc6', 'F-7': 'f7', 'F-8': 'f8', 'F-9': 'f9', 'F-10': 'f10',

  The genacls.pkgdb file also needs to be updated for active branches to

      ACTIVE = {'OLPC-2': 'olpc2/', 'EL-4': 'el4/', 'EL-5': 'el5/',

                'EL-6': 'el6/', 'F-11': 'f11/', 'F-12': 'f12/', 'F-13': 'f13/',

  fedora-release

  --------------

  * Use pkgdb to request an F-15 branch of fedora-release

  * Use pkgdb2branch.py to actually make the branch

  * Update fedora-release clone

  * commit/build

  * Track build in koji to ensure proper tagging is used

  ^^^^^^^^^^^^^^^^^^

  Required permissions: provenpackage for GIT, cvsadmin for Package DB.

  replace them with a ``dead.package`` file whose contents describe why the

  package is dead. Also the package needs to be marked as retired in PackageDB.

  Fedpkg takes care of this:

  This should return nothing, as the ``wdm`` package is blocked.

  Also check that package DB shows that the package is retired and that the

  Consider Before Running

  =======================

  .. _FTBFS: https://fedoraproject.org/wiki/Fails_to_build_from_source

  ---------------

  All the following listed repos needs updating, including adding a new branch

  1. https://pagure.io/pungi-fedora

  2. https://pagure.io/fedora-kickstarts

      +++ b/roles/pkgdb-proxy/files/pkgdb-gnome-software-collections.json

      @@ -4,8 +4,8 @@

             "allow_retire": true,

             "date_created": "2014-05-14 12:36:15",

      -      "date_updated": "2019-08-14 17:07:23",

      -      "dist_tag": ".fc32",

  Koji

  ----

  The koji build system needs to have some tag/target work done to handle builds

  Run `make-koji-release-tags`_ script in `pagure releng`_ repo

  Fedora Release

  --------------

  The Fedora release package needs to be updated in both the new branch and in

  ::

  Similar to fedora-release, fedora-repos package also needs to be updated.

  ::

  ^^^^^^^^^^^^^^^^^^

  In releng repository update `script

  And set current_rawhide variable.

  .. _pkgdb-proxy role:

  .. _packages3 role:

  .. _bodhi2 role:

  .. _greenwave openshift role:

  .. _mbs role:

  .. _releng role:

  .. _robosignatory role:

  .. _make-koji-release-tags:

  .. _pagure releng:

      https://pagure.io/releng

  .. _create_emtpy_repos.sh:

  .. _File a Taskotron ticket:

      https://pagure.io/taskotron/new_issue?title=Fedora%20Branched%20notification&content=Fedora%20NN%20is%20now%20Branched

  .. _Fedora Layered Image Build System:

      https://docs.pagure.org/releng/layered_image_build_service.html

  .. _fedscm-admin commit:

  .. _block_retired.py:

  .. _block_retired.py commit:

  .. _fedora infra ticket:

      https://pagure.io/fedora-infrastructure/issue/9239#comment-671446

  Kickstart files are used to configure how the image is built and what is available in the image

  The solution consist of 3 Kickstarts.

  be used to modify other releases.

  Compose Configuration (Pungi)

  For rawhide the configuration is in

  While for other releases the configuration is in a dedicated file

  If you want to release the base image on registry.fp.o and quay.io you can use the following

  script.

  You will need to run that script from on of the releng composer machines in the infrastructure

  in order to have the credentials.

  For the details on how to run the script please see

  Consider Before Running

  =======================

  Make sure that the branch in question isn't one of our pre-created branches

  Sometimes, packagers request that we *unretire* a package branch that has

  previously been retired.

  any stable or arbitrary branch.

  Action

  The documentation is now live.

  .. note::

      the releng repository. If you are curious whom all has this ability, please

      refer to the :doc:`Main Page <index>` and contact someone from the "Team

      Composition"

  log = logging.getLogger(__name__)

  PRODUCTION_PDC = "https://pdc.fedoraproject.org"

  STAGING_PDC = "https://pdc.stg.fedoraproject.org"

          if namespace == "container":

              # git branchname, koji tag, epel build tag

              self.mapping = (

                  ("f33", "f33-container", ""),

                  ("f32", "f32-container", ""),

                  ("f31", "f31-container", ""),

          else:

              # git branchname, koji tag, epel build tag

              self.mapping = (

                  ("f33", "f33", ""),

                  ("f32", "f32", ""),

                  ("f31", "f31", ""),

      return unblocked, blocked

      """

      Get a list of all unblocked pacakges in a branch.

      """

      return unblocked

      retiredpkgs = []

      # PDC uses singular names such as rpm and container

      if namespace.endswith('s'):

      return process, stdout, stderr

      if isinstance(packages, str):

          packages = [packages]

      parser.add_argument("packages", nargs="*", metavar="package",

                          help="Packages to block, default all retired packages")

      parser.add_argument(

          help="Branch to retire specified packages on, default: %(default)s")

      parser.add_argument(

          "--staging", default=False, action="store_true",

      nms: This is the namespace, not necessary default is "rpms"

      pck: This is the name of the fedora package, user has to input this, has no default value

  """

  parser = argparse.ArgumentParser()

  parser.add_argument("--nms", help="Name of the namespace that contains package", type=str, default="rpms")

  parser.add_argument("pck", help="Name of the fedora package", type=str)

  args = parser.parse_args()

  # this is the default url used for getting contributors the url is api/0/<namespace>/<package>

  Examples:

  -\------A---\

  without checking any builds.

    /---/-------\-B"-B'-B

            \--C

  'B' has commits that are not found anywhere else (B, B', and B"), and

  cannot check if builds have been performed, so this script always

  refuses removal.

  3. Removal is refused in some additional corner cases:

  - the spec file cannot be parsed

          branch_name = branch.branch_name[l+1:]

          local = False

          return 1

      if bodhi_builds_exist(branch_name, opts.package, opts):

  published."""

  BRANCH_HIERARCHY = {

      "f25": "f26",

      "f24": "f25",

      "epel7": "",

      "el6": ""

  }

      # First, check to see if it is retired.

      # PDCClient pulls connection information from /etc/pdc.d/

      # develop=True means: don't authenticate.

  if __name__ == "__main__":

      parser = argparse.ArgumentParser(description="Helper to retire packages")

                          choices=BRANCH_HIERARCHY.keys())

      parser.add_argument("--dry-run", default=False, action="store_true")

      parser.add_argument("--reasonfile", default=None)

      source_repo='https://kojipkgs.fedoraproject.org/compose/rawhide/'

                  'latest-Fedora-Rawhide/compose/Everything/source/tree/',

      tag='f34',

      mailto='devel@lists.fedoraproject.org',

      bcc=[],

  )

  Release Engineering. Please report issues at its pagure instance:

  https://pagure.io/releng/

  The sources of this script can be found at:

  """

          continue

      # Check out git

      print('Checking out %s' % name)

      if runme(fedpkgcmd, 'fedpkg', name, enviro):

          continue

  # Set some variables

  # Some of these could arguably be passed in as args.

  buildtag = 'f27' # tag to build from

  secondbuildtag = 'f26' # tag to build from

  comment = '- Rebuilt for https://fedoraproject.org/wiki/Fedora_26_27_Mass_Rebuild'

  workdir = os.path.expanduser('~/massbuild-gcc')

  enviro = os.environ

  enviro['CVS_RSH'] = 'ssh' # use ssh for cvs

  pkg_skip_list = ['fedora-release', 'fedora-repos', 'fedora-modular-release', 'fedora-modular-repos', 'generic-release',

      #   continue

      # check the git hashes of the branches

          sys.stderr.write('%s has no git hash.\n' % name)

          break

              sys.stderr.write('%s failed spec check\n' % name)

              continue

              # rpmdev-bumpspec

              bumpspec = ['rpmdev-bumpspec', '-u', user, '-c', comment,

                          os.path.join(workdir, name, spec)]

                           cwd=os.path.join(workdir, name)):

                  continue

          else:

              if runme(gitmergecmd, 'git', name, enviro,

                           cwd=os.path.join(workdir, name)):

                  continue

          continue

      # Check out git

      print('Checking out %s' % name)

      if runme(fedpkgcmd, 'fedpkg', name, enviro):

          continue

          print('<dd><a href="http://koji.fedoraproject.org/koji/packageinfo?packageID=%s">%s</a></dd>' % (pkg, pkg))

      print('</dl>')

  print('<p>The script that generated this page can be found at ')

  print('There you can also report bugs and RFEs.</p>')

  print('</body>')

  print('</html>')

                          help="Uses the stg instance instead of the real pdc.")

      parser.add_argument(

      parser.add_argument(

          'txtlist',

          help="Filename containing list of packages to critpath")