Télécharger via un proxy avec la tâche get d'Ant

La tâche get d'Ant utilise la configuration réseau de la JVM qui exécute Ant. Un proxy peut être défini avant le téléchargement avec setproxy :

<target name="download">
  <setproxy proxyhost="proxy.example.net"
            proxyport="8080"
            nonproxyhosts="localhost|127.*|*.internal.example.net"/>
  <get src="https://downloads.example.net/tool.zip"
       dest="tool.zip"/>
</target>

Les noms et le port sont des exemples. Pour une requête d'artefact public autorisée à utiliser des proxys publics, prenez un point de terminaison HTTP dans la liste de proxys HTTP. La liste d'exclusion utilise des barres verticales, pas des virgules. N'incluez que les destinations qui doivent réellement passer en direct ; un téléchargement interne routé via un proxy externe peut échouer même lorsque le proxy fonctionne correctement.

L'ordre compte. Placez la tâche de proxy avant l'opération get, que ce soit dans la même cible ou dans une cible préalable. Une configuration après le début du téléchargement ne peut pas modifier cette connexion.

Deux connexions sont possibles. Les attributs proxyuser et proxypassword de setproxy concernent l'intermédiaire. Les attributs username et password de get concernent le serveur de téléchargement. Fournir le compte du proxy à get ne le transforme pas en authentification proxy. La prise en charge et les restrictions d'authentification dépendent aussi du JDK et du mécanisme exigé par le proxy.

Le paramètre a une portée JVM. Il convient aux tâches Ant qui utilisent ce chemin réseau, mais il ne configure pas tous les exécutables externes lancés par une compilation. Il peut aussi affecter des tâches réseau ultérieures dans le même processus Ant. Gardez les points de terminaison et les secrets propres au site dans la configuration locale de la compilation plutôt que d'intégrer le compte d'un développeur dans une cible partagée.

Si le système d'exploitation fournit déjà la route voulue, Ant documente aussi -autoproxy pour la découverte du système d'exploitation sur les environnements Java pris en charge. C'est une autre source de configuration de routage. Pour une compilation qui a besoin d'un point de terminaison explicite, la tâche ci-dessus rend visibles la route choisie et son moment.