Self-hosted repo

billsimon · January 22, 2020, 9:02pm

Does anyone have instructions on how to set up a FreePBX mirror/repo?

mbrooks · January 23, 2020, 1:46pm

Having worked with the mirror a bit over the past few months, I don’t think it’s possible at this time. The licensing and module downloads are all mixed together right now, so that would have to be separated before we could do something like you’re talking about. I do believe the project could definitely benefit from having community hosted or even private mirrors.

billsimon · January 23, 2020, 2:43pm

For those who are using the open-source-licensed modules only I think it would be nice if FreePBX had a switch that allowed you to just point to the Github repo or git.freepbx.org.

You might be able to offload some traffic if you went that way also.

jfinstrom · January 23, 2020, 2:55pm

Over simplified you need a web server that generates

http://mirror.freepbx.org/all-15.0.xml

Then you need it to return files based on location. So something like mirror.freepbx.org/modules/module/module-foo-15.0.1.tgz would return the tar ball

The actual mirror server does do a lot of crap. That said the mirror portion is as simple and complex as above.

The mirror server is not really a releasable thing. Nor as @mbrooks mentioned is it written in a way that that piece can be broken out.

billsimon · January 23, 2020, 3:15pm

Unless you’re a competitive startup with prior knowledge?

The XML manifest and tgz packages are really what I’m after, so thanks for the tip, though unfortunately only the Sangoma mirrors have the .sig files (not sure why - am I missing something about how signatures work?) - so mirroring against github isn’t really going to work.

jfinstrom · January 23, 2020, 4:23pm

I wrote the mirror for a certain startup. I wasn’t involved in the original mirror, the rewrite, nor any of the maintenance. So I had to figure it all out. Basically went through the framework moduleadmin class and fed it what it was asking for.

Module.sig is part of the package. It isn’t hosted separately. It is generated on packaging and how to do it is documented
https://wiki.freepbx.org/display/FOP/Signing+your+own+modules

tl;dr you use the devtools package

run ./sign.php moduledir KEYID
Then you tar up the result

I think the mirror ward did simply pulled the github packages then concatenated the module.xml files. I never looked at it but I know it was static.

jfinstrom · January 23, 2020, 4:27pm

A good starting point:

github.com

FreePBX/framework/blob/release/14.0/amp_conf/htdocs/admin/libraries/modulefunctions.class.php#L1257


			return array(_("Failed to run enable method"));
		}


		//enable all jobs
		\FreePBX::Job()->setEnabledByModule($modulename, true);


		return true;
	}


	/**
	* Downloads the latest version of a module and extracts it to the directory
	* @param string    The location of the module to install
	* @param bool      If true, skips status and dependency checks
	* @param string    The name of a callback function to call with progress updates.
	*                   function($action, $params). Possible actions:
	*                     getinfo: while downloading modules.xml
	*                     downloading: while downloading file; params include 'read' and 'total'
	*                     untar: before untarring
	*                     done: when complete
	* @return  mixed   True if succesful, array of error messages if not succesful
	*/

github.com

FreePBX/framework/blob/release/14.0/amp_conf/htdocs/admin/libraries/modulefunctions.class.php#L1936


		return true;
	}


	/**
	* Installs or upgrades a module from it's directory
	* Checks dependencies, and enables
	* @param string   The name of the module to install
	* @param bool     If true, skips status and dependency checks
	* @return mixed   True if succesful, array of error messages if not succesful
	*/
	function install($modulename, $force = false) {
		$this->getInfoCache = array(); //invalidate local
		$this->modDepends = array();
		$this->notFound = false;
		global $db, $amp_conf;


		set_time_limit($this->maxTimeLimit);


		// make sure we have a directory, to begin with
		$dir = $amp_conf['AMPWEBROOT'].'/admin/modules/'.$modulename;
		if (!is_dir($dir)) {

system · February 23, 2020, 4:27pm

This topic was automatically closed 31 days after the last reply. New replies are no longer allowed.